skill-creator

To generate LLM agent skills with valid YAML frontmatter, use this tool to create a SKILL.md file containing a one-line YAML-safe description with trigger words and an LLM runtime instruction body. It ensures repo-specific style compliance and organizes supporting content in assets and references directories.

The correct structure for an OpenCode SKILL.md file includes valid YAML frontmatter, an LLM runtime instruction body, and an output contract. Supporting templates and schemas are placed in the assets directory, while extensive explanations and references point to local documentation.

You should create a reusable skill for agent workflows when a non-trivial pattern is repeated and requires decision gates, guardrails, and concise operational instructions. This ensures agents can activate the workflow predictably across different contexts.

Yes, skill creation works with a repo style guide by automatically applying docs/skill-style-guide.md when available to enforce repo-specific rules. If no style guide exists, it falls back to inline rules to maintain structure and compliance.

The limitation of automating skill generation is that it targets repeated, non-trivial workflow patterns requiring decision gates and guardrails. It is not intended for simple, one-off tasks that do not need structured LLM runtime contracts or operational instructions.