add-a-new-skill

To create step-by-step guides for in-app skills, run the `add-a-new-skill` command to author new Markdown files with YAML frontmatter. This generates structured recipe documentation for studio workflows.

The best way to document workflow recipes for a dev assistant is using Markdown for operational instructions and YAML frontmatter for metadata. This Skill mirrors recipes to the .agents directory for dev assistant suggestions.

Recipe mirroring for studio tooling duplicates your authored step-by-step guides into the .agents mirror. This allows the dev assistant to access and suggest top recipes directly within the studio environment.

Yes, you need YAML frontmatter to define skill metadata when authoring documentation. It pairs with Markdown formatted operational instructions to create complete in-app skill recipes.

Yes, you can use this to add new recipes to an existing studio environment. It streamlines workflow documentation by creating MD files that define step-by-step instructions specifically for the in-app Skills tool.

A limitation when mirroring recipes to the .agents directory is that the Skill is strictly intended for workflow documentation within a studio environment and relies on specific YAML and Markdown formatting.