/publish-skill

Publish Skill to Docs Site

Sync a marketplace skill to the documentation site. Creates skill detail pages (EN/ZH), updates the marketplace index, and updates docs.json navigation.

Arguments

• `$ARGUMENTS` — Skill directory name under `marketplace/skills/` (e.g., `cc-codex-spec-bootstrap`). If omitted, list available skills and ask.

Steps

Step 1: Identify the Skill

# If no argument, list available skills
ls marketplace/skills/

Read the skill's `SKILL.md` to extract:

• **name** (from frontmatter)
• **description** (from frontmatter)
• What the skill does (from body)
• Prerequisites / tools needed
• What files are included

cat marketplace/skills/<skill-name>/SKILL.md

Step 2: Check Existing Docs

Verify the skill doesn't already have docs pages:

ls docs-site/skills-market/<skill-name>.mdx 2>/dev/null

If pages already exist, ask user if they want to update them.

Step 3: Create EN Detail Page

Create `docs-site/skills-market/<skill-name>.mdx`.

Follow the format of existing skill pages (see `docs-site/skills-market/trellis-meta.mdx` as reference):

---
title: '<skill-name>'
description: '<one-line description>'
---

<what the skill does - 1-2 paragraphs>

## Install

```bash
npx skills add mindfold-ai/Trellis/marketplace --skill <skill-name>

Or install all available skills:

npx skills add mindfold-ai/Trellis/marketplace

Options:

| Flag | Description | | --- | --- | | `-g` | Install globally (`~/.claude/skills/`) | | `-a claude-code` | Target a specific agent | | `-y` | Non-interactive mode |

Verify Installation

...

Usage

<example prompts>

What's Included

<table of directories/files>

### Step 4: Create ZH Detail Page

Create `docs-site/zh/skills-market/<skill-name>.mdx` with Chinese translation of the EN page.

### Step 5: Update Index Pages

Add the skill to the Official Skills table in both:
- `docs-site/skills-market/index.mdx`
- `docs-site/zh/skills-market/index.mdx`

### Step 6: Update docs.json

Add the new page to both EN and ZH Skills navigation groups in `docs-site/docs.json`:

- EN: `"skills-market/<skill-name>"` in the Skills pages array
- ZH: `"zh/skills-market/<skill-name>"` in the ZH Skills pages array

### Step 7: Commit and Push Docs

```bash
cd docs-site
git add skills-market/<skill-name>.mdx zh/skills-market/<skill-name>.mdx \
  skills-market/index.mdx zh/skills-market/index.mdx docs.json
git commit -m "docs: add <skill-name> skill to marketplace"
git push

Step 8: Ensure Skill on Main Branch

If the marketplace skill isn't on `main` yet (e.g., committed on a feature branch):

# Check if skill exists on main
git log main --oneline -- marketplace/skills/<skill-name>/ | head -1

If not on main, cherry-pick the commit:

# Find the commit that added the skill
git log --oneline -- marketplace/skills/<skill-name>/ | head -1

# Cherry-pick to main
git stash
git checkout main && git pull
git cherry-pick <commit-hash>
git push origin main
git checkout - && git stash pop

Step 9: Confirm

Report:

• Docs-site pages created (EN + ZH)
• Index pages updated
• docs.json updated
• Docs-site pushed
• Marketplace skill available on main