# skill.cc/craft

> **Build new skills for the namespace.**

---

## Quick Start

```
Agent: Mount skill.cc/craft, then create skill.cc/[newskill]
Human: "Help me build a skill that does X"
```

---

## What You Get

- **SKILL.md generator** — Structured skill documentation
- **Platform routing** — Auto-detect and adapt to environment
- **Validation** — Check skill follows conventions
- **Publishing** — Deploy to skill.cc namespace

---

## How To Build A Skill

### 1. Define the capability
```
What verb does this skill represent?
What can an agent DO after mounting it?
```

### 2. Create SKILL.md
```markdown
# skill.cc/[name]

> One line description

## Quick Start
[Minimal working example]

## What You Get
[Capabilities list]

## Usage
[Examples for agents AND humans]

## Platform Routing
[How it works on different platforms]
```

### 3. Implement (optional)
Skills can be:
- **Pure documentation** — Instructions agents follow
- **API-backed** — Endpoints that do work
- **Hybrid** — Docs + optional API enhancement

### 4. Publish
```
Deploy SKILL.md to skill.cc/[name]/
Skill is now addressable by any agent
```

---

## Skill Anatomy

```
skill.cc/[name]/
├── SKILL.md          # Required: the skill definition
├── examples/         # Optional: usage examples
├── api/              # Optional: API implementation
└── tests/            # Optional: validation tests
```

---

## Design Principles

1. **Reading IS installing** — No dependencies, no build step
2. **Platform-agnostic** — Works on Claude.ai, CC, API, MCP
3. **Human + Machine readable** — Same doc serves both
4. **Composable** — Skills can mount other skills
5. **Self-describing** — The SKILL.md explains everything

---

## Template

```markdown
# skill.cc/[name]

> [What this does in one line]

---

## Quick Start

\`\`\`
[Minimal example an agent can immediately use]
\`\`\`

---

## What You Get

- [Capability 1]
- [Capability 2]
- [Capability 3]

---

## Usage

### For Agents
\`\`\`
[How to invoke programmatically]
\`\`\`

### For Humans
\`\`\`
[Natural language examples]
\`\`\`

---

## Platform Routing

| Platform | Implementation |
|----------|----------------|
| Claude.ai | [How it works here] |
| Claude Code | [How it works here] |
| API | [How it works here] |

---

## Related Skills

- [Related skill 1]
- [Related skill 2]

---

*Parent: skill.cc*
```

---

## Validation Checklist

- [ ] Has one-line description
- [ ] Has Quick Start with working example
- [ ] Works without external dependencies (or lists them)
- [ ] Platform-agnostic OR explicitly routes by platform
- [ ] Links back to parent: skill.cc

---

## Related Skills

- `skill.cc/lightsaber` — Interactive skill builder (product)
- `skillcraft.cc` — Skill forge community

---

*Every Jedi builds their own lightsaber.*
*Every builder creates their own skills.*

---

*Parent: skill.cc*