install-skill

Skill Installer

Automates the installation of new skills into the skills marketplace project. Handles unpacking, marketplace registration, and documentation updates.

When to Use

• User has a .skill file in dist/ directory
• User asks to "install", "add", "unpack", or "integrate" a skill
• User wants to add a new skill to the marketplace

Installation Workflow

Phase 1: Discovery

1. List available skill packages:

``bash ls -la dist/*.skill ``

1. Identify target skill: If user specifies a skill name, use it. Otherwise, list available packages and ask which to install.

1. Verify package: Check the file exists and is a valid zip archive:

``bash file dist/<skill-name>.skill ``

Phase 2: Extraction

1. Preview contents before extracting:

``bash unzip -l dist/<skill-name>.skill ``

1. Extract to project root:

``bash unzip -o dist/<skill-name>.skill ``

1. Verify extraction:

``bash ls -la <skill-name>/ ls -la <skill-name>/references/ ``

Phase 3: Metadata Extraction

1. Read SKILL.md frontmatter to extract:
2. name: Skill identifier (kebab-case)
3. description: Full description for triggers
4. metadata.category: Category (seo, music, security, tooling, etc.)
5. metadata.tags: Comma-separated tags

1. Parse the frontmatter between --- markers at the top of SKILL.md

1. Generate short description for marketplace (one line, ~60 chars max)

Phase 4: Marketplace Registration

1. Update .claude-plugin/marketplace.json:

a. Update the top-level description if needed to include new category

b. Add to plugins array: ``json { "name": "<skill-name>", "type": "skill", "path": "<skill-name>", "description": "<short-description>", "category": "<category>", "tags": ["tag1", "tag2", ...] } ``

c. Add category to categories object if new: ``json "<category>": { "name": "<Category Display Name>", "description": "<Category description>", "marketplace": "marketplace-<category>.json" } ``

1. Create/update category marketplace (marketplace-<category>.json):

If file doesn't exist, create with template: ``json { "name": "skills-<category>", "version": "1.0.0", "description": "<Category> skills for Claude Code.", "author": "schwepps", "license": "MIT", "repository": { "type": "git", "url": "https://github.com/schwepps/skills.git" }, "plugins": [ { / skill entry / } ] } ``

If file exists, add skill to plugins array.

Phase 5: Documentation Update

1. Update README.md:

a. Update header description if new category added

b. Add to "What's Included" table: ``markdown | [<skill-name>](<skill-name>/) | <short-description> | ``

c. Add usage examples section if new category: ``markdown ### <Category> ` "Example prompt 1" "Example prompt 2" ` ``

d. Add to "Project Structure" tree: `` ├── <skill-name>/ ``

e. Add to "Browser Download" table: ``markdown | <Skill Display Name> | Download ZIP | ``

Phase 6: Verification

1. Verify all files updated:
2. [ ] Skill directory exists with SKILL.md and references/
3. [ ] marketplace.json contains skill entry
4. [ ] Category marketplace file exists and contains skill
5. [ ] README.md updated with skill info

1. Report summary:

``` Installed: <skill-name> Category: <category> Files: <count> reference files

Updated:

• .claude-plugin/marketplace.json
• .claude-plugin/marketplace-<category>.json
• README.md

```

Category Mappings

| Category | Display Name | Description | |----------|--------------|-------------| | seo | SEO & AI Search | Search engine optimization and AI search visibility | | music | Music Creation | AI-powered music and audio generation | | security | Smart Contract Security | Blockchain and smart contract auditing | | tooling | Developer Tools | Automation and development utilities |

Error Handling

• File not found: List available .skill files in dist/
• Invalid package: Check if file is valid zip archive
• Missing SKILL.md: Package is malformed, cannot install
• Missing frontmatter: Extract what's possible, ask user for missing metadata
• Category conflict: Ask user to confirm category assignment

Quick Install Command

For a straightforward installation with a known skill file:

/install-skill <skill-name>

This will:

1. Unpack dist/<skill-name>.skill
2. Auto-detect metadata from SKILL.md
3. Register in all marketplace files
4. Update README.md
5. Report completion status