---
name: treehouse-skills
description: Manage your custom Claude Code skills using the tc CLI. Use this when the user wants to create, edit, list, or delete their own custom skills. Always use `tc skills` commands — never write to .claude/skills/ directly, as changes made outside tc will not persist across sessions.
---

# Managing Skills with tc

Tenant agents can create and manage their own persistent skills using the `tc` CLI. Skills are stored in `/workspace/shared/skills/` and automatically available in the current session.

## Commands

```bash
tc skills list                          # List your custom skills
tc skills create <name> [description]   # Create a new skill (stub)
tc skills write <name> --content <text> # Write full SKILL.md content
tc skills delete <name>                 # Delete a custom skill
```

## Writing a Full Skill

Use `tc skills write` to create or replace a skill with complete SKILL.md content:

```bash
tc skills write my-skill --content "---
name: my-skill
description: What this skill does and when to use it.
---

# My Skill

Instructions for the skill go here."
```

## Rules

- Always use `tc skills` to create/edit/delete skills — never write to `.claude/skills/` directly
- Skill names must be lowercase with hyphens (e.g. `my-skill`)
- The `description` field in the frontmatter controls when Claude auto-invokes the skill
- Changes take effect immediately in the current session
- Skills persist in `/workspace/shared/skills/` across session restarts
