# Claude Skills Collection

Custom Claude Code skills to replace heavy MCP servers with lightweight CLI wrappers.

## Why This Repo?

Some MCP servers consume massive amounts of context. This repo provides lightweight skill alternatives that:
- ✅ Only load when invoked (vs. always loaded MCPs)
- ✅ Use standard CLI tools (tea, gh, etc.)
- ✅ Save context budget for actual work
- ✅ Can be shared across projects

## Skills

### gitea

Wraps the `tea` CLI for Gitea repository management.

**Replaces:** Gitea MCP (42.7k tokens → ~2k tokens)

**Commands:** Issues, PRs, releases, labels, milestones, repos

**Installation:**
```bash
# Install tea CLI
brew install tea

# Configure for your Gitea instance
tea login add --url https://gitea.kostverse.com --token YOUR_TOKEN --name kostverse

# Copy skill to personal skills directory
cp -r gitea ~/.claude/skills/

# Restart Claude Code
```

**Usage:**
```
/gitea
```

Then use standard tea CLI commands as shown in the skill instructions.

## Contributing

To add a new skill:
1. Create a directory with `SKILL.md`
2. Include YAML frontmatter with name and description
3. Document common operations
4. Test it works
5. Submit PR

## Context Savings

| MCP Server | Tokens | Skill Alternative | Tokens | Savings |
|------------|--------|-------------------|--------|---------|
| Gitea MCP  | 42.7k  | gitea skill       | ~2k    | 95%     |

More skills coming as we identify heavy MCPs to replace.