skill scaffold

The problem

Starting a new skill from a blank file often leads to avoidable rejections. Small mistakes in frontmatter, weak descriptions that agents can't match, or missing mandatory sections like "Safety" waste development cycles on bureaucracy instead of logic.

What it does

• Generates a complete repo skeleton including SKILL.md, README.md, and a script stub.
• Automates kebab-case frontmatter normalization and enforces agent-friendly description lengths.
• Injects mandatory marketplace sections including When-to-use, What-it-does, and Safety with TODO markers.
• Validates existing skills using the --check flag to identify potential soft-rejections before submission.

Frameworks & tools

Supports Python, Node.js, and Shell script stubs. Compatible with any environment running Python 3 for the scaffold CLI.

Why this beats prompting it yourself

Generic LLMs often hallucinate frontmatter formats or omit the specific structural requirements reviewers look for. This tool uses a deterministic script to ensure your base package is 100% compliant, so you only have to focus on the core agent logic.

Use cases

• Bootstrapping a new AI agent skill from a one-line concept.
• Auditing an existing SKILL.md for metadata compliance and trigger clarity.
• Creating standardized boilerplate for a library of internal skills.
• Quickly generating language-specific script stubs for Python or Node components.

Known limitations

This tool creates the skeleton only. It does not write the actual logic or fill in the TODO markers for your specific implementation.