writing-skills

To create a standardized SKILL.md, build a canonical file with frontmatter including name, description, argument-hint, and disable-model-invocation set to false. Establish the skill directory under .agents/skills to ensure consistent documentation and safe model execution.

The required frontmatter schema for skill authoring includes name, description, and argument-hint fields, along with a mandatory disable-model-invocation flag set to false. This standardizes documentation and ensures safe workflow automation across projects.

Organize skill files by grouping optional references, templates, and helper scripts within the skill directory alongside the canonical SKILL.md. This structure supports reuse and maintains consistency across your workflow automation projects.

The best way to structure scalable Claude workflow skills is to integrate them into the .agents/skills directory using a standardized frontmatter schema and clear body template. This maintains consistent naming, documentation, and safe automation across projects.

The disable-model-invocation flag must be set to false as a safety constraint to ensure controlled execution within the Claude workflow. This standardization prevents unauthorized model actions and maintains secure skill automation.

Yes, you can add optional references, scripts, and assets to an existing skill directory. The canonical frontmatter schema accommodates these additions while maintaining the required name, description, and safety constraints for consistent documentation.