_template

Provides a boilerplate SKILL.md and slash-command template for authoring new agent-flywheel skills.

3|1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill template-burningportra
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: _template
Source: https://github.com/burningportra/agent-flywheel-plugin/tree/main/skills/_template
Command: npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill template-burningportra

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? New contributors to the agent-flywheel plugin lack a consistent starting point for authoring skills, leading to malformed frontmatter, vague invocation triggers, and slash commands that fail to register in Claude Code. ## Core Features & Use Cases - SKILL.md scaffold: Ships a fully commented frontmatter template covering required fields (name, description) and optional fields (allowed-tools, argument-hint), plus a structured body with When-to-invoke, step, and error-handling sections. - Slash-command template: Includes commands-example.md, which contributors copy into the commands/ directory so the new skill is invocable as /agent-flywheel:<name>. - Authoring conventions: Documents error routing on FlywheelErrorCode via result.structuredContent, AskUserQuestion for user decisions, and references to exemplar skills (flywheel-doctor, start, flywheel-status). - Use Case: A contributor wants to add a new flywheel skill; they copy skills/_template, rename the directory, fill in the frontmatter and steps, and copy commands-example.md into commands/ to expose the slash command. ## Quick Start Copy the _template skill directory, rename it to your new skill name, and fill in the SKILL.md frontmatter and step instructions.

Frequently Asked Questions about _template

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new skill for the agent-flywheel plugin?

Copy the skills/_template directory, rename it to your skill name, and set the name field in SKILL.md to match the directory exactly. Then fill in the description, When-to-invoke triggers, and step instructions in the body.

How do I add a slash command for a Claude Code skill?

Copy commands-example.md into the commands/ directory with your skill name as the filename, for example commands/my-skill.md. The filename becomes the slash command, invoked as /agent-flywheel:my-skill with the plugin namespace added automatically.

What frontmatter fields are required in a SKILL.md file?

Only name and description are required. The name must match the directory name exactly, and the description should be one verb-first sentence under 200 characters. Optional fields include allowed-tools and argument-hint.

How should skills handle errors from flywheel MCP tools?

Branch on result.structuredContent?.data?.error?.code rather than parsing error.message, since every flywheel tool returns a tagged FlywheelErrorCode in a Zod-validated envelope. Surface error.hint inline as the user's next step.

When should a skill use AskUserQuestion instead of free-text prompts?

Use AskUserQuestion whenever the skill terminates with or depends on a user decision. The template mandates this per the universal rules in skills/start/SKILL.md so no implicit choices are made.