MUST USE when building, validating, or auditing Agent Skills according to the official Agent Skills specification from agentskills.io. Creates compliant SKILL.md files with proper frontmatter, implements progressive disclosure, and validates against the open standard format.
Creates compliant Agent Skills with proper SKILL.md files and validates against the open standard.
/plugin marketplace add Git-Fg/thecattoolkit/plugin install sys-meta@cattoolkitThis skill is limited to using the following tools:
references/expert-protocol.mdreferences/official-docs.mdThis skill implements the official Agent Skills framework from agentskills.io, an open standard developed by Anthropic for extending AI agent capabilities.
Agent Skills are folders containing a SKILL.md file with YAML frontmatter and Markdown instructions. This skill helps you create, validate, and maintain skills that comply with the official specification.
A valid skill must be a directory containing at minimum a SKILL.md file:
skill-name/
└── SKILL.md # Required
Optional directories for enhanced skills:
skill-name/
├── SKILL.md # Required: metadata + instructions
├── scripts/ # Optional: executable code
├── references/ # Optional: additional documentation
└── assets/ # Optional: templates, resources
Every SKILL.md must contain:
YAML Frontmatter (Required):
---
name: skill-name
description: A description of what this skill does and when to use it.
---
Markdown Body: Step-by-step instructions, examples, and guidance.
Skills use progressive disclosure to manage context efficiently:
name and description loaded at startupSKILL.md loaded when skill is activatednamepdf-processing, data-analysis, code-reviewdescriptiondescription: "Extracts text and tables from PDF files, fills PDF forms, and merges multiple PDFs. Use when working with PDF documents or when the user mentions PDFs, forms, or document extraction."
licensecompatibilitymetadatametadata:
author: example-org
version: "1.0"
allowed-tools (Experimental)Use the official skills-ref validation library:
skills-ref validate <path>
Check:
For existing skills, verify:
Frontmatter Compliance:
Structure Compliance:
Content Quality:
Good Example:
description: "Extracts text and tables from PDF files, fills PDF forms, and merges multiple PDFs. Use when working with PDF documents or when the user mentions PDFs, forms, or document extraction."
Poor Example:
description: "Helps with PDFs."
SKILL.md (<400 lines - router):
references/ (detailed theory):
scripts/ (executable code):
Use relative paths from skill root:
See the official [Agent Skills specification](https://agentskills.io/) for details.
Run the extraction script:
scripts/extract.py
Keep references one level deep from SKILL.md.
Agent Skills are supported by leading AI development tools. The format was developed by Anthropic and released as an open standard.
Discovery Process:
Security Considerations:
Use the official skills-ref library:
Validate a skill directory:
skills-ref validate <path>
Generate <available_skills> XML:
skills-ref to-prompt <path>...
Creating a PDF Processing Skill:
# 1. Create directory
mkdir pdf-processing
cd pdf-processing
# 2. Create SKILL.md with proper frontmatter
cat > SKILL.md << 'EOF'
---
name: pdf-processing
description: "Extracts text and tables from PDF files, fills PDF forms, and merges multiple PDFs. Use when working with PDF documents or when the user mentions PDFs, forms, or document extraction."
---
# PDF Processing Skill
## When to use this skill
Use this skill when...
EOF
# 3. Add optional directories
mkdir scripts references assets
# 4. Validate
skills-ref validate pdf-processing
Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.
Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.