skill writer

Design Community

Skill notes

When to use this Skill

Use this Skill when: Creating a new Agent Skill Writing or updating SKILL.md files Designing skill structure and frontmatter Troubleshooting skill discovery issues

Step 1: Determine Skill scope

First, understand what the Skill should do: Ask clarifying questions: What specific capability should this Skill provide? When should Claude use this Skill? What tools or resources does it need?

Step 2: Choose Skill location

Determine where to create the Skill: Personal Skills (~/.claude/skills/): Individual workflows and preferences Experimental Skills Personal productivity tools

Step 3: Create Skill structure

Create the directory and files: For multi-file Skills:

Step 4: Write SKILL.md frontmatter

Create YAML frontmatter with required fields: Field requirements: name: Lowercase letters, numbers, hyphens only Max 64 characters

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Design
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@Microck · no license declared
Token usage
Lean
Setup complexity
Guided setup
External API key
Not required
Operating systems
Unspecified (assume cross-platform)
Runtime requirements
Python
Detected file/system behavior
  • Read-only
  • Write / modify
  • Shell exec
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

01
Step 1: Determine Skill scope

First, understand what the Skill should do: Ask clarifying questions: What specific capability should this Skill provide? When should Claude use this Skill? What tools or resources does it need?

02
Step 2: Choose Skill location

Determine where to create the Skill: Personal Skills (`~/.claude/skills/`): Individual workflows and preferences Experimental Skills Personal productivity tools

03
Step 3: Create Skill structure

Create the directory and files: For multi-file Skills:

04
Step 4: Write SKILL.md frontmatter

Create YAML frontmatter with required fields: Field requirements: name: Lowercase letters, numbers, hyphens only Max 64 characters

05
Step 5: Write effective descriptions

The description is critical for Claude to discover your Skill. Formula: `[What it does] + [When to use it] + [Key triggers]` Examples: ✅ Good: ✅ Good:

06
Step 6: Structure the Skill content

Use clear Markdown sections: pip install package-name

07
Step 7: Add supporting files (optional)

Create additional files for progressive disclosure: reference.md: Detailed API docs, advanced options examples.md: Extended examples and use cases scripts/: Helper scripts and utilities templates/: File templates or boilerplate

08
Step 8: Validate the Skill

Check these requirements: ✅ File structure: [ ] SKILL.md exists in correct location [ ] Directory name matches frontmatter `name` ✅ YAML frontmatter:

09
Step 9: Test the Skill

Restart Claude Code (if running) to load the Skill Ask relevant questions that match the description: Verify activation: Claude should use the Skill automatically Check behavior: Confirm Claude follows the instructions correctly

10
Step 10: Debug if needed

If Claude doesn't use the Skill: Make description more specific: Add trigger words Include file types Mention common user phrases

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.