# Claude OS Skills Management

Manage Claude Code skills - list, install from templates, create custom, and configure.

## Commands

```
/claude-os-skills                    - List all skills (global + project)
/claude-os-skills templates          - Show available templates
/claude-os-skills install <name>     - Install template to project
/claude-os-skills create             - Create a custom skill
/claude-os-skills view <name>        - View skill details
/claude-os-skills delete <name>      - Delete a project skill
```

---

## LIST SKILLS (default)

When user runs `/claude-os-skills` with no arguments:

**Step 1: Get Skills**
```
mcp__code-forge__list_skills
  project_path: "{cwd}"
```

**Step 2: Display Results**
```
═══════════════════════════════════════
📚 CLAUDE CODE SKILLS
═══════════════════════════════════════

🌐 GLOBAL SKILLS (always available)
────────────────────────────────────
  ✓ memory - Save and recall information
  ✓ memory - Auto-save on trigger phrases

📁 PROJECT SKILLS ({cwd})
────────────────────────────────────
  ✓ rails-backend - Rails patterns and service objects
  ✓ rspec - RSpec testing patterns

💡 TIP: Run '/claude-os-skills templates' to see available templates
═══════════════════════════════════════
```

---

## LIST TEMPLATES

When user runs `/claude-os-skills templates`:

**Step 1: Get Templates**
```
mcp__code-forge__list_skill_templates
```

**Step 2: Display by Category**
```
═══════════════════════════════════════
📦 SKILL TEMPLATES
═══════════════════════════════════════

GENERAL
────────────────────────────────────
  • initialize-project
    Analyze codebase, generate docs
    Tags: onboarding, analysis

RAILS
────────────────────────────────────
  • rails-backend
    Service objects, ActiveRecord, APIs
    Tags: ruby, rails, backend

REACT
────────────────────────────────────
  • react-patterns
    Hooks, TypeScript, components
    Tags: react, typescript, frontend

TESTING
────────────────────────────────────
  • rspec
    RSpec patterns, factories
    Tags: ruby, rspec, tdd

───────────────────────────────────────
Install with: /claude-os-skills install <name>
═══════════════════════════════════════
```

---

## INSTALL TEMPLATE

When user runs `/claude-os-skills install <name>`:

**Step 1: Install Template**
```
mcp__code-forge__install_skill_template
  template_name: "<name>"
  project_path: "{cwd}"
```

**Step 2: Confirm**
```
✓ Installed '<name>' to {cwd}/.claude/skills/<name>

The skill is now available in this project!

To use it, Claude Code will automatically load it when relevant,
or you can explicitly invoke it with: skill: <name>
```

---

## CREATE CUSTOM SKILL

When user runs `/claude-os-skills create`:

**Step 1: Gather Information**

Ask the user for:
1. Skill name (e.g., "deployment", "code-review")
2. Description (one sentence)
3. Content (the skill instructions)

**Step 2: Create Skill**
```
mcp__code-forge__create_skill
  name: "<name>"
  description: "<description>"
  content: "<content>"
  project_path: "{cwd}"
```

**Step 3: Confirm**
```
✓ Created skill '<name>' in {cwd}/.claude/skills/<name>

The skill is now available in this project!
```

---

## VIEW SKILL

When user runs `/claude-os-skills view <name>`:

**Step 1: Get Skill Details**

First try project scope, then global:
```
mcp__code-forge__get_skill
  name: "<name>"
  scope: "project"
  project_path: "{cwd}"
```

If not found:
```
mcp__code-forge__get_skill
  name: "<name>"
  scope: "global"
```

**Step 2: Display Skill**
```
═══════════════════════════════════════
📖 SKILL: <name>
═══════════════════════════════════════

Scope: project
Source: template
Category: rails
Tags: ruby, rails, backend

─────────────────────────────────────

<skill content here>

═══════════════════════════════════════
```

---

## DELETE SKILL

When user runs `/claude-os-skills delete <name>`:

**Step 1: Confirm with User**
```
⚠️  Are you sure you want to delete the '<name>' skill?

This will remove it from {cwd}/.claude/skills/<name>

Type 'yes' to confirm, or anything else to cancel.
```

**Step 2: Delete if Confirmed**
```
mcp__code-forge__delete_skill
  name: "<name>"
  project_path: "{cwd}"
```

**Step 3: Confirm**
```
✓ Deleted skill '<name>' from project
```

**Note:** Cannot delete global skills (memory, memory). These are core to Claude OS.

---

## SKILL LOCATIONS

- **Global Skills**: `~/.claude/skills/`
  - Available in ALL projects
  - Core skills: memory, memory

- **Project Skills**: `{project}/.claude/skills/`
  - Available only in that project
  - Installed from templates or custom created

- **Templates**: `claude-os/templates/skill-library/`
  - Categorized templates to install

---

## TIPS

1. **Start with templates** - Install what you need per-project
2. **Keep global minimal** - Only core skills should be global
3. **Customize templates** - After installing, edit for your needs
4. **Create custom skills** - Document project-specific patterns

---

## EXAMPLES

```
/claude-os-skills
→ Lists all global and project skills

/claude-os-skills templates
→ Shows available templates by category

/claude-os-skills install rails-backend
→ Installs Rails patterns to current project

/claude-os-skills create
→ Interactive custom skill creation

/claude-os-skills view rails-backend
→ Shows full skill content

/claude-os-skills delete old-skill
→ Removes skill from project (after confirmation)
```