FAQs
Everything you need to know about AGENT KD SKILL — installing, using, and contributing skills.
What is AGENT KD SKILL?
AGENT KD SKILL is a gallery of SKILL.md variants for AI coding agents. Every skill ships as a 3-file bundle (markdown, JSON, assembly manifest) organized by agent role and filterable by platform. It supports Claude Code, opencode, Codex CLI, Cursor, and Gemini CLI.
What is a SKILL.md file?
A SKILL.md is a markdown file with JSON frontmatter that tells an AI agent how to behave in a specific domain. It contains instructions, rules, processes, and constraints that the agent follows when the skill is loaded. Think of it as a reusable prompt template for specialized tasks.
How do I install a skill?
1. Find the skill card in the gallery and click Download.
2. Create a folder in your agent's skills directory (e.g. ~/.config/opencode/skills/my-skill/).
3. Copy the downloaded SKILL.md into that folder.
4. Restart your agent session. The skill auto-loads based on its description.
Where do I put the SKILL.md file?
Each agent has its own skills directory:
opencode: ~/.config/opencode/skills/<name>/SKILL.md
Claude Code: ~/.claude/skills/<name>/SKILL.md
Codex CLI: ~/.codex/skills/<name>/SKILL.md
Cursor: ~/.cursor/skills/<name>/SKILL.md
Gemini CLI: ~/.gemini/skills/<name>/SKILL.md
What is the 3-file bundle?
Every skill ships with three files:
SKILL.md — The human-readable instructions (markdown + JSON frontmatter).
<name>-skill.json — Machine-readable metadata (role, platform, description, install paths).
assembly.json — The assembly manifest that binds the other two. This is what compilers and loaders read to resolve a complete, installable skill.
What does "assembly.json" do?
assembly.json is the single source of truth for a skill. It declares the skill's name, title, role, platform, which files compose it, and how it's installed and invoked. Any tooling — a build pipeline, agent loader, or compiler — can resolve a complete skill from assembly.json alone without parsing prose.
What are the role categories?
Skills are organized by agent role:
AGENT PLAN — Research, scope, and sequence work before coding.
AGENT BUILD — Convert plans into production code.
AGENT COMPACT — Minimal token footprint for fast subagent work.
AGENT CAPABILITY — Platform-agnostic capabilities (design, search, capture).
AGENT SUB — Sub-agent orchestration (isolation, budgets, handoffs).
AGENT DEEP — Deep research (planning, chunked digestion, synthesis).
AGENT MICRO — Tiny single-purpose agents (strict schemas, minimal prompts).
CUSTOM SKILL — Curated third-party skills (e.g. Matt Peacock's collection).
How do I use a skill after installing it?
Restart your agent session, then invoke the skill by typing @<skill-name> or by asking the agent something related to the skill's purpose. The agent will follow the instructions in the SKILL.md file automatically.
Can I use these skills with any agent?
Yes. All skills follow the open Agent Skills standard (SKILL.md + name/description frontmatter). Any agent that reads this format — Claude Code, opencode, Codex CLI, Cursor, Gemini CLI, or future agents — can use them without modification.
What is the "How to use?" guide on each card?
Every skill card includes a step-by-step installation guide: download the file, copy it to your agent's skills directory, restart your session, and verify. The guide is also embedded inside each SKILL.md file itself.
How do I add my own skill to the gallery?
1. Create a folder under skills/custom/<your-skill>/.
2. Add three files: SKILL.md, <name>-skill.json, and assembly.json.
3. Add your skill entry to the SKILLS array in app.js.
4. Run node scripts/build-content.mjs to regenerate the catalog.
5. Submit a pull request to the GitHub repo.
What is the star rating system?
Every CUSTOM SKILL card has a 0–5 star rating (Least Used → Most Popular). Click a star to rate the skill. Your ratings are saved in your browser's localStorage and persist across sessions. This helps you track which skills you use most.
Who created these skills?
The platform skills (PLAN, BUILD, COMPACT) were built by Melvin @ KrackedDevs. The CUSTOM SKILL collection (31 skills) is curated from Matt Peacock's open-source mattpocock/skills repository (MIT license). Design snippets are credited in the README.
Is this project open source?
Yes. The full source code is on GitHub. You can fork it, add your own skills, and submit pull requests. The gallery is a static site — no server required.
How do I rebuild the gallery after adding skills?
Run these commands from the project root:
node scripts/build-content.mjs — Rebuilds data/skills.js with all skill entries.
node scripts/compile-skills.mjs — Compiles token-optimized artifacts under data/compiled/.
Does the gallery work on mobile?
Yes. The gallery is fully responsive. On mobile, the sidebar becomes a centered "Home" pill. You can pull down to navigate to krackeddevs.com. Cards use lazy loading and batched rendering for smooth scrolling on all devices.
What browsers are supported?
All modern browsers: Chrome, Firefox, Safari, Edge. The gallery uses backdrop-filter for glass effects (supported in all major browsers). Reduced-motion preferences are respected for users who disable animations.