Notre avis
Automatise la publication d'une skill du marketplace sur le site de documentation : création des pages de détail EN et ZH, mise à jour de l'index et de la navigation docs.json, puis commit, push et vérification de la présence de la skill sur main.
Points forts
- Couvre toute la chaîne de publication en une seule commande, de la lecture du SKILL.md jusqu'au push des pages.
- Maintient la parité entre la version anglaise et la version chinoise des pages de détail et des index.
- Met à jour docs.json pour les deux groupes de navigation, ce qui évite les oublis de référencement.
- S'appuie sur une page existante (trellis-meta.mdx) comme modèle pour garantir un format homogène.
Limites
- Très lié à l'arborescence d'un dépôt précis (marketplace/skills/, docs-site/, docs.json de Mintlify) et difficile à réutiliser ailleurs.
- La traduction chinoise est produite sans relecture humaine, la qualité dépend donc du modèle.
- L'étape de cherry-pick vers main suppose un arbre de travail propre et peut échouer en cas de conflit, sans vérification du build du site.
À utiliser lorsqu'une skill du marketplace doit être rendue publique avec ses pages de documentation anglaise et chinoise et son entrée dans la navigation.
À éviter si le site de documentation n'utilise pas cette structure Mintlify avec docs.json, ou s'il s'agit de documenter autre chose qu'une skill du marketplace.
Analyse de sécurité
PrudenceThe skill automates documentation publishing with git operations including commit, push, branch checkout, and cherry-pick. These are legitimate development workflow actions but carry meaningful risk of unintended remote changes or branch state disruption, warranting caution.
- •Executes git push to remote repositories without explicit confirmation or safeguards.
- •Performs branch manipulation (checkout main, cherry-pick, push origin main) that can alter repository state and remote history.
- •Uses shell commands despite declaring no allowed tools, which may bypass agent tool restrictions.
Exemples
Publish the skill cc-codex-spec-bootstrap to the docs site.Run the publish-skill-to-docs workflow — list the skills under marketplace/skills/ and let me pick one.Sync marketplace/skills/my-new-skill to the docs site (EN + ZH pages, index, docs.json) and make sure the skill itself is on main.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 undermarketplace/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.mdxdocs-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
Generateur de Documentation API
Documentation
Genere automatiquement de la documentation API OpenAPI/Swagger.
Rédacteur Technique
Documentation
Rédige de la documentation technique claire selon les meilleurs style guides.
Révision du contenu existant
Documentation
Révise les pages de documentation sélectionnées par le workflow quotidien, applique uniquement les corrections à haute confiance et ouvre des PR auditable. Conçu pour le pipeline de révision de contenu.