incomestreamsurfer/claude-skills-collection/agent-skills-guide
Claude Code and agent skill by incomestreamsurfer/claude-skills-collection
- community
Checking that the SKILL.md file is still in the repository.
Guide for creating, managing, and using Claude Code Agent Skills. Use when the user asks about Skills, wants to create a new Skill, or needs help with SKILL.md files.
Install
npx vskill@latest install incomestreamsurfer/claude-skills-collection/agent-skills-guideSKILL.md
The same SKILL.md was published earlier as incomestreamsurfer/claude-skills-collection/agent-skills-guide.
Agent Skills Guide
What are Agent Skills?
Agent Skills package expertise into discoverable capabilities for Claude Code. Each Skill consists of:
- A
SKILL.mdfile with instructions (required) - Optional supporting files (scripts, templates, references)
Key distinction: Skills are model-invoked (Claude autonomously decides when to use them based on task context), unlike slash commands which are user-invoked.
Skill Locations
Personal Skills
- Path:
~/.claude/skills/<skill-name>/SKILL.md - Available across all projects
- Use for: Individual workflows, experimental skills, personal productivity
Project Skills
- Path:
.claude/skills/<skill-name>/SKILL.md - Shared via git with team members
- Use for: Team workflows, project-specific expertise, shared utilities
Plugin Skills
- Bundled with installed Claude Code plugins
- Automatically available when plugin is installed
SKILL.md Structure
Field Requirements
name: Lowercase letters, numbers, hyphens only (max 64 chars)description: What the Skill does AND when to use it (max 1024 chars)allowed-tools: Optional comma-separated list of permitted tools
Best Practices
Write Effective Descriptions
The description is critical for Claude to discover when to use your Skill.
Bad (too vague):
Good (specific):
Keep Skills Focused
One Skill = one capability. Split broad concepts into separate Skills.
Good: "PDF form filling", "Excel data analysis", "Git commit messages" Bad: "Document processing" (too broad)
Multi-File Skills Structure
Reference files from SKILL.md - Claude loads them only when needed (progressive disclosure).
Testing Skills
Test by asking questions that match your description:
Claude automatically activates Skills based on task context.
Debugging Skills
Skill Not Activating
- Make description more specific with trigger terms
- Verify file path is correct
- Check YAML syntax (no tabs, correct indentation)
- Run
claude --debugto see loading errors
Common Issues
- Missing opening/closing
---in frontmatter - Tabs instead of spaces in YAML
- Unquoted strings with special characters
Sharing Skills
Via Git (Project Skills)
Via Plugins (Recommended for Distribution)
Create a plugin with Skills in the skills/ directory and distribute through marketplaces.
Example Skills
Simple Single-File Skill
Read-Only Skill with Tool Restrictions
Frontend Design Skill Example
For improved UI generation, use targeted prompting across:
- Typography: Avoid generic fonts (Inter, Roboto), use distinctive choices
- Color & Theme: Commit to cohesive aesthetics, use CSS variables
- Motion: Animations for effects and micro-interactions
- Backgrounds: Create atmosphere and depth, avoid solid colors
Commands
View available Skills:
List Skills manually:
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/agent-skills-guide/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/incomestreamsurfer/claude-skills-collection/agent-skills-guide)