skill-creator_skill

Overview

This skill creates new AI agent skills that follow the Agent Skills specification and Prowler conventions. It triggers when a user asks to create a new skill, add agent instructions, or document recurring patterns for AI. The skill enforces naming, frontmatter, and content rules so skills are consistent and discoverable.

How this skill works

It inspects the requested pattern and guides the author through required fields, critical patterns, and minimal code examples. It recommends whether to include assets (templates, schemas) or references (local docs), enforces frontmatter fields, and produces a ready-to-add skill package structure. It also runs a checklist to ensure the skill is reusable, correctly named, and documented with commands and examples.

When to use it

• A pattern is used repeatedly and AI needs explicit guidance
• Project-specific conventions differ from generic best practices
• You must document a complex workflow or decision tree for agent behavior
• When adding agent instructions or standard templates for reuse
• Do not use for one-off tasks, trivial patterns, or when authoritative docs already exist

Best practices

• Start with the most critical patterns the agent must follow
• Keep code examples minimal, focused, and copy-paste ready
• Include a Commands section with common copy-paste commands
• Choose assets/ for templates and schemas; choose references/ for local docs only
• Follow required frontmatter: name, description (with trigger), license, metadata.author, metadata.version
• Run the pre-creation checklist to avoid duplicates and ensure reusability

Example use cases

• Create a prowler-iam skill describing IAM hardening patterns and enforcement steps
• Author a generic pytest or typescript skill with minimal examples and commands
• Add agent instructions that define decision trees for remediation versus alerting
• Provide reusable templates and JSON schemas in assets/ for automated checks
• Document project-specific naming and frontmatter rules for new contributors