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

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