install-skill — Claude Code command: install skills and agents
Prints step-by-step instructions for placing a generated skill or agent where Claude can find it, with the install routes laid out to pick from.
MIT ★ 907 updated 2025-11-12
.claude/commands/install-skill.mdWhat install-skill does
Give the command a path to a generated skill or agent and it returns install steps. The type comes from the path: skills in it brings three routes (drag the ZIP into Claude Desktop, copy the folder into ~/.claude/skills/, or import through skill-creator in the browser). agents in it brings two: keep the file in .claude/agents/ for this project, or copy it to ~/.claude/agents/ so every project sees it.
Verification follows: ls on the target folder, head -10 on SKILL.md, and /agents in Claude to check the name is listed. An agent that never fires on its own often has a description too vague to match the task.
Run /validate-output before installing. Invalid YAML frontmatter means the skill will not load after a restart. Rebuilding a broken ZIP needs zip on the machine.
What it helps with
- copy a finished skill into
~/.claude/skills/with the right path - decide between project-level and user-level for an agent
- confirm a skill actually loaded after restarting
- rebuild a corrupted ZIP for Claude Desktop import
- find out why an agent never invokes itself
Example prompts for the agent
/install-skill generated-skills/healthcare-analyzer— walk me through installing it everywhere/install-skill .claude/agents/code-reviewer— project or user-level, which one fits?/install-skill generated-skills/my-skill— show the steps and verify the result
How to install install-skill
Manually: put the files in place
.claude/commands/install-skill.mdCall it with /install-skill. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/install-skill.mdCall it with /prompts:install-skill. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/install-skill.prompt.mdManually: put the files in place
.gemini/commands/install-skill.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about install-skill
How do I install install-skill in Claude Code?
Place the command file at .claude/commands/install-skill.md in your project, then restart Claude. It shows up as /install-skill.
What does install-skill do?
It explains where a generated skill or agent belongs and offers the routes: Claude Desktop with a ZIP, the ~/.claude/skills/ folder, or .claude/agents/.
How does installing a skill differ from installing an agent?
A skill is a folder holding SKILL.md; it goes into ~/.claude/skills/ or arrives as an imported archive. An agent is a single .md file in .claude/agents/ or ~/.claude/agents/.
Source text
install-skill.md · MIT
# /install-skill - Install Generated Skills or Agents **Step-by-step guide to install your generated skills and agents to the correct locations.** --- ## Usage ``` /install-skill [path-to-skill] /install-skill [path-to-agent] ``` --- ## What This Command Does Provides step-by-step installation instructions for: - **Claude Skills** → `~/.claude/skills/` or Claude Desktop import - **Claude Agents** → `.claude/agents/` (project) or `~/.claude/agents/` (user-level) Shows multiple installation methods and helps choose the best one. --- ## Install a Skill ``` /install-skill generated-skills/my-skill ``` **Output**: ``` Installing: my-skill You have 3 installation options: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Option 1: Claude Desktop (Easiest) 1. Locate ZIP file: generated-skills/my-skill.zip 2. Open Claude Desktop app 3. Drag and drop the ZIP file into Claude 4. Skill will load automatically! ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Option 2: Claude Code (User-level) Available across ALL your Claude Code projects: ```bash # Copy skill folder cp -r generated-skills/my-skill ~/.claude/skills/ # Verify installation ls ~/.claude/skills/my-skill/ # Restart Claude Code (if currently running) ``` ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Option 3: Claude Apps (Browser) 1. Go to Claude.ai 2. Enable Skills (Settings → Features) 3. Use the "skill-creator" skill 4. Import the ZIP file ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Which option? (1, 2, or 3): ___ ``` **After user chooses**, provide detailed steps for that option. --- ## Install an Agent ``` /install-skill .claude/agents/my-agent ``` (Note: Works for both skills and agents despite command name) **Output**: ``` Installing: my-agent.md (Claude Code Agent) You have 2 installation options: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Option 1: Project-level (This project only) Available only in the claude-code-skills-factory project: ```bash # File already in correct location! .claude/agents/my-agent.md # Restart Claude Code to load # Agent will auto-invoke when relevant tasks detected ``` ✅ Recommended if: Agent is specific to this factory project ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Option 2: User-level (All projects) Available across ALL your Claude Code projects: ```bash # Copy to user-level location cp .claude/agents/my-agent.md ~/.claude/agents/ # Verify installation ls ~/.claude/agents/my-agent.md # Restart Claude Code ``` ✅ Recommended if: Agent is useful across multiple projects ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Which option? (1 or 2): ___ ``` --- ## Automatic Detection **If path contains "skills"**: → Provides skill installation instructions (3 options) **If path contains "agents"**: → Provides agent installation instructions (2 options) **If unclear**: ``` What type of output are you installing? 1. Claude Skill (folder with SKILL.md, goes to ~/.claude/skills/) 2. Claude Agent (single .md file, goes to .claude/agents/ or ~/.claude/agents/) Your choice: ___ ``` --- ## Verification Steps **After installation**, the command helps verify: **For Skills**: ```bash # Check skill installed ls ~/.claude/skills/my-skill/ # Verify SKILL.md head -10 ~/.claude/skills/my-skill/SKILL.md # In Claude Desktop: Skills menu should show "my-skill" ``` **For Agents**: ```bash # Check agent installed ls .claude/agents/my-agent.md # or ls ~/.claude/agents/my-agent.md # In Claude Code: Run /agents # Should list "my-agent" in available agents ``` --- ## Common Installation Paths **Claude Skills**: - User-level: `~/.claude/skills/[skill-name]/` - Desktop: Import ZIP via drag-and-drop - Browser: Use skill-creator **Claude Agents**: - Project-level: `.claude/agents/[agent-name].md` - User-level: `~/.claude/agents/[agent-name].md` --- ## Examples ### After Building a Healthcare Skill ``` # 1. Build /build skill [Answer questions about healthcare data analysis] [Skill generated: generated-skills/healthcare-analyzer/] # 2. Validate /validate-output skill generated-skills/healthcare-analyzer ✅ Validation passed # 3. Install /install-skill generated-skills/healthcare-analyzer Choose Option 2 (Claude Code user-level) [Follow provided commands] # 4. Verify ls ~/.claude/skills/healthcare-analyzer/ ✅ Installed ``` ### After Building a Code Reviewer Agent ``` # 1. Build /build agent [Answer questions about code review] [Agent generated: .claude/agents/code-reviewer.md] # 2. Validate /validate-agent .claude/agents/code-reviewer ✅ Validation passed # 3. Install /install-skill .claude/agents/code-reviewer Choose Option 1 (Project-level, already in place) [Just restart Claude Code] # 4. Verify /agents ✅ "code-reviewer" listed ``` --- ## Troubleshooting **"Skill not loading after installation"**: - Restart Claude Code or Claude Desktop - Check file is in correct location - Verify YAML frontmatter is valid (/validate-output first) **"Agent not auto-invoking"**: - Check /agents to see if it's listed - Verify description is specific enough - Try manual invocation: "Use the [agent-name] agent to..." **"ZIP import failing"**: - Verify ZIP file exists and isn't corrupted - Re-create ZIP if needed: ```bash cd generated-skills zip -r my-skill.zip my-skill/ ``` --- ## Tips **Before Installing**: - ✅ Always run /validate-output first - ✅ Fix any validation errors - ✅ Test locally if possible **After Installing**: - ✅ Restart Claude Code/Desktop - ✅ Test with simple invocation - ✅ Share with team (if useful) **For Skills**: - Desktop: Easiest (drag-and-drop) - Code: Most flexible (edit files directly) - Browser: Good for quick sharing **For Agents**: - Project-level: If agent is project-specific - User-level: If agent is useful everywhere --- ## Related Commands - `/build` - Generate skills/prompts/agents first - `/validate-output` - Validate before installing - `/test-factory` - Test after installing - `/factory-status` - See installation status --- **Make installation easy and error-free!** 📦
© alirezarezvani · MIT · alirezarezvani/claude-code-skill-factory