guidance

Solid

Authoritative guidance for building Claude Code skills, agents, and plugins, vendored into this repository. Use when you need the rules or best practices for a skill, agent, hook, or plugin — designing, reviewing, hardening, or checking one against the guidance. Does not run an interview to build a new skill or agent from scratch — use skill-builder or agent-builder. Does not write feature code, review application code, or build non-plugin features.

Web & Frontend 126 stars 13 forks Updated 2 days ago MIT

Install

View on GitHub

Quality Score: 84/100

Stars 20%
70
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
86
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

Serve the relevant guidance for what the user is building. Do not read every guidance document — that defeats the purpose. Find the one or two that apply, read them, and apply them. The guidance documents live in this skill's own `references/` directory. Use this map to choose, then read only the specific file(s) you need: - Deciding whether something should be a skill, agent, or hook → `${CLAUDE_SKILL_DIR}/references/plugin-entity-taxonomy.md`. - Authoring or hardening a skill (descriptions, frontmatter, progressive disclosure, allowed-tools, scripts, composition, testing, troubleshooting) → the files under `${CLAUDE_SKILL_DIR}/references/skill-building-guidance/`. - Authoring an agent (domain focus, self-containment, model selection, multi-agent economics, graceful degradation) → the files under `${CLAUDE_SKILL_DIR}/references/agent-building-guidelines/`. - Plugin or marketplace configuration files (plugin.json, marketplace.json, monitors.json, themes.json) → the files under `${CLAUDE_SKILL_DIR}/references/claude-marketplace-and-plugin-configuration/`. - Versioning, README structure, local development, the iterative development process, and specialization-versus-model-tier reasoning → the top-level files in `${CLAUDE_SKILL_DIR}/references/`. - Copyable starter files → `${CLAUDE_SKILL_DIR}/references/templates/`. Steps: 1. Identify what the user is building or asking about. 2. List the relevant subdirectory under `${CLAUDE_SKILL_DIR}/references/` to ...

Details

Author
testdouble
Repository
testdouble/han
Created
2 months ago
Last Updated
2 days ago
Language
Shell
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

Web & Frontend Solid

skill-builder

Builds a new Claude Code skill from scratch through a relentless, evidence-based interview that walks the skill's design tree decision-by-decision — entity fit, use cases, name, description, workflow steps, tools, and progressive-disclosure layout — then reviews the finished skill against the plugin-building guidance and applies every fix it finds. Use when creating, authoring, scaffolding, designing, or drafting a new skill or slash command. Does not build an agent or subagent — use agent-builder. Does not serve, vendor, or refresh the authoring guidance itself — use guidance.

126 Updated 2 days ago
testdouble
AI & Automation Solid

agent-builder

Builds a new Claude Code agent (subagent) from scratch through a relentless, evidence-based interview that walks the agent's design tree decision-by-decision — entity fit, domain focus and vocabulary, role identity, anti-patterns, description, model tier, tools, and self-containment — then reviews the finished agent against the plugin-building guidance and applies every fix it finds. Use when creating, authoring, scaffolding, designing, or drafting a new agent or subagent. Does not build a skill or slash command — use skill-builder. Does not serve, vendor, or refresh the authoring guidance itself — use guidance.

126 Updated 2 days ago
testdouble
AI & Automation Listed

claude-code-framework

Authoritative reference for how Claude Code itself works AND how to build for it — CLAUDE.md memory, custom slash commands, subagents, skills, hooks, MCP servers, settings precedence, permissions, plan mode, CLI/headless/CI, worktrees, and multi-platform surfaces. Use when authoring or debugging a plugin component (command/agent/skill/hook), wiring an MCP server, choosing frontmatter fields, configuring settings.json or permissions, figuring out why an agent/skill won't auto-trigger, running headless/CI or worktree-parallel sessions, or answering "how does Claude Code X work / how should I structure this for Claude Code."

5 Updated 2 days ago
nxtg-ai