skill-writer

The skill-writer is an essential utility for developers and AI engineers designing technical documentation meant for autonomous agents. It standardizes the creation of SKILL.md files, ensuring that agent-consumable content is correctly indexed by registries like ClawdHub or MoltHub and easily parsed by LLM-based agents. By enforcing a consistent schema, it helps you define clear trigger scenarios, metadata, and task-oriented content sections that improve agent activation rates and overall instruction performance.

• Standardizes YAML frontmatter including name, description, and clawdbot metadata schemas.

• Provides templates for 'When to Use' sections to clarify agent activation triggers.

• Encourages task-oriented content structure instead of abstract conceptual explanations.

• Enforces the inclusion of runnable code blocks with language identifiers and realistic data examples.

• Facilitates cross-platform support definitions (linux, darwin, win32) and dependency management (requires.anyBins).

• Use this when creating new skills to ensure they are machine-readable and semantically optimized for vector search.

• Ideal for documenting CLI wrappers, automation scripts, and project-level task runners.

• Follow the recommended 'What it does. Use when [trigger].' pattern for search-indexed descriptions.

• Ensure code blocks include output comments and specific technical implementations to avoid ambiguity.

• Always validate skill slugs for collisions using registry lookup tools before final publishing.

• Incorporate the 'Tips' section to provide distilled expert advice that agents can prioritize during execution.