MakeCoder SkillHub

# Skill: skillhub

Interact with [skillhub](https://makecoder.com/skillhub) using the `coder skills` subcommands built into this CLI.

## Commands

### List your published skills
```bash
coder skills list
```
Calls `GET /api/v1/me/skills` and displays namespace/slug, stars, downloads, and status.

### Search skills
```bash
coder skills search <keyword>
```

### Publish a skill
```bash
# Publish current directory to the global namespace (default)
coder skills publish

# Publish to a specific namespace (visibility auto-locked to NAMESPACE_ONLY)
coder skills publish --namespace myteam

# Publish with explicit visibility
coder skills publish --visibility PRIVATE

# Publish a specific directory or zip file
coder skills publish ./my-skill-dir
coder skills publish --namespace myteam my-skill.zip
```

**Visibility rules:**
- `global` namespace (default): PUBLIC / NAMESPACE_ONLY / PRIVATE — your choice
- Any other namespace: automatically locked to `NAMESPACE_ONLY`

The skill directory must contain a valid `SKILL.md` with correct frontmatter. Publishing zips the directory via `git archive` (respects `.gitignore`) or falls back to `zip`.

### Unpublish (delete) a skill
```bash
coder skills unpublish <namespace>/<slug>

# Example
coder skills unpublish global/my-skill
```
Calls `DELETE /api/v1/skills/{namespace}/{slug}`.

### View your namespaces
```bash
coder skills namespaces
```
Lists all namespaces you belong to (slug, display name, type, status).

### Install / remove / update local skills
```bash
coder skills add <name>        # install from skillhub registry
coder skills remove <name>     # uninstall locally
coder skills update [name]     # update one or all local skills
```

## Authentication

All skillhub commands require a valid API Key. Log in first:
```bash
coder login
```

## SKILL.md frontmatter reference

Every skill package must have a `SKILL.md` at its root with valid frontmatter:

```markdown
---
name: my-skill
description: One-line description shown in search results
triggers:
  - keyword that activates this skill
---
```

## Workflow: publish a new skill

1. Create a directory for your skill
2. Add `SKILL.md` with frontmatter
3. Add any supporting files (scripts, templates, etc.)
4. Run `coder skills publish` from inside the directory
5. Check status with `coder skills list`