skill creator doctor

Documentation Community

Skill notes

About Skills

Skills are modular, self-contained packages that extend Claude's capabilities by providing specialized knowledge, workflows, and tools. Think of them as "onboarding guides" for specific domains or tasksβ€”they transform Claude from a general-purpose agent into a specialized agent equipped with procedural knowledge that no model can fully possess.

What Skills Provide

Specialized workflows - Multi-step procedures for specific domains Tool integrations - Instructions for working with specific file formats or APIs Domain expertise - Company-specific knowledge, schemas, business logic Bundled resources - Scripts, references, and assets for complex and repetitive tasks

Anatomy of a Skill

Every skill consists of a required SKILL.md file and optional bundled resources: SKILL.md (required) Metadata Quality: The name and description in YAML frontmatter determine when Claude will use the skill. Be specific about what the skill does and when to use it. Use the third-person (e.g. "This skill should be used when..." instead of "Use this skill when..."). Bundled Resources (optional) Scripts (scripts/)

Progressive Disclosure Design Principle

Skills use a three-level loading system to manage context efficiently: Metadata (name + description) - Always in context (~100 words) SKILL.md body - When skill triggers (<5k words) Bundled resources - As needed by Claude (Unlimited*) *Unlimited because scripts can be executed without reading into context window.

Skill Creation Process

To create a skill, follow the "Skill Creation Process" in order, skipping steps only if there is a clear reason why they are not applicable.

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Documentation
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
94 / 100 Β· heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@ananddtyagi Β· Complete terms in LICENSE.txt
Token usage
Heavy
Setup complexity
Guided setup
External API key
Not required
Operating systems
macOS Β· Linux Β· Windows
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.

Output preview skill-creator-doctor.preview
# Step 1: Understanding the Skill with Concrete Examples

- "What functionality should the image-editor skill support? Editing, rotating, anything else?"
- "Can you give some examples of how this skill would be used?"
- "I can imagine users asking for things like 'Remove the red-eye from this image' or 'Rotate this image'. Are there other ways you imagine this skill being used?"
- "What would a user say that should trigger this skill?"

Discussion

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