Help us improve
Share bugs, ideas, or general feedback.
From build-agent-skills
Creates, validates, and publishes Agent Skills following the agentskills.io open standard. Use when authoring portable skills for Claude Code, Cursor, GitHub Copilot, and other AI agents.
npx claudepluginhub agentic-insights/foundry --plugin build-agent-skillsHow this skill is triggered — by the user, by Claude, or both
Slash command
/build-agent-skills:agentskills-ioThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Create portable skills for AI agents. Works with Claude Code, Cursor, GitHub Copilot, OpenAI integrations, VS Code (symlinks enable sharing across tools).
Provides behavioral guidelines to reduce common LLM coding mistakes, focusing on simplicity, surgical changes, assumption surfacing, and verifiable success criteria.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Guides systematic root-cause debugging when tests fail, builds break, or unexpected errors occur. Provides a structured triage checklist to preserve evidence, localize, and fix issues instead of guessing.
Share bugs, ideas, or general feedback.
Create portable skills for AI agents. Works with Claude Code, Cursor, GitHub Copilot, OpenAI integrations, VS Code (symlinks enable sharing across tools).
skill-name/
├── SKILL.md # Required (frontmatter + instructions, <5000 tokens activation)
├── scripts/ # Optional: executable code
├── references/ # Optional: detailed docs
└── assets/ # Optional: templates, static files
Rules: Dir name = frontmatter name:. Only 3 subdirs. SKILL.md <500 lines. ~100 tokens for discovery (name+desc).
name: 1-64 chars, lowercase alphanumeric-hyphens (^[a-z0-9]+(-[a-z0-9]+)*$)description: 1-1024 chars, include "Use when..." (discovery budget: ~100 tokens)license: SPDX identifier (Apache-2.0, MIT) | compatibility: Environment reqs (<500 chars)metadata: Key-value pairs (author, version, tags) | allowed-tools: Space-delimited tool list# Install permanently (vs ephemeral uvx)
uv tool install git+https://github.com/agentskills/agentskills#subdirectory=skills-ref
# Or use uvx for one-shot validation
uvx --from git+https://github.com/agentskills/agentskills#subdirectory=skills-ref skills-ref validate ./skill
| Command | Description |
|---|---|
skills-ref validate <path> | Check structure, frontmatter, token budgets |
skills-ref read-properties <path> | Extract metadata |
skills-ref to-prompt <path> | Generate prompt format |
command" not "You might want to..."| Error | Fix |
|---|---|
| Invalid name | Lowercase alphanumeric-hyphens only |
| Missing description | Add description: field with "Use when..." |
| Description too long | <1024 chars, move details to body |
| Invalid YAML | Check indentation, quote special chars |
| Missing SKILL.md | Filename must be exactly SKILL.md |
| Dir name mismatch | Directory name must match name: field |
mkdir skill-name && touch skill-name/SKILL.mdskills-ref validate ./skill-nameplugin-name/
├── .claude-plugin/plugin.json
├── README.md, LICENSE, CHANGELOG.md # CHANGELOG.md tracks versions
├── skills/skill-name/SKILL.md
├── agents/ # Optional: subagents (.md files)
└── examples/ # Optional: full demo projects
Distinctions: Plugin examples/ = runnable projects. Skill assets/ = static resources only.
bash scripts/validate-skills-repo.sh # Validate all skills in repo
bash scripts/bump-changed-plugins.sh # Auto-bump only changed plugins (semver)
---
name: example-skill
description: Brief description. Use when doing X.
---
# Example Skill
## Prerequisites
- Required tools
## Instructions
1. First step: `command`
2. Second step with example
## Troubleshooting
**Error**: Message → **Fix**: Solution
Share skills across Claude Code, Cursor, VS Code: ln -s /path/to/skills ~/.cursor/skills