Skill Market
myqz-wld/skill-market
Marketplace de skills nativo para Claude e Codex com gestão integrada
Ver no GitHubMarketplace nativo de plugins para Claude e Codex com gerenciamento completo de skills. Oferece funcionalidades de listagem, busca, download, instalação, atualização e desinstalação de skills através de skills nativos empacotados como plugins.
Instalação
npx convez-ai myqz-wld/skill-market1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerenciar catálogo de skills para Claude e Codex
- Instalar e atualizar skills via CLI nativo
- Buscar e descobrir skills disponíveis no marketplace
- Publicar e manter skills próprios no repositório
Veredito

Solução arquitetural bem estruturada para federação de skills em Claude/Codex. Requer compreensão profunda de manifests, plugins nativos e workflows de CLI — ideal para integradores que precisam manter múltiplas skills em produção.
README
A tradução para o português deste README ainda está na fila.
Skill Market
Skill Market is a native plugin marketplace repository for Claude and Codex.
It does not provide a service, API, custom CLI, or custom installer. Claude and Codex use their own plugin marketplace mechanisms. The built-in capabilities are management skills packaged as native plugins for each platform.
Marketplace Layout
.claude-plugin/marketplace.json # Claude marketplace catalog
.agents/plugins/marketplace.json # Codex marketplace catalog
plugins/
skill-market-claude/
.claude-plugin/plugin.json
skills/
skill-market/SKILL.md
skill-list/SKILL.md
skill-search/SKILL.md
skill-download/SKILL.md
skill-install/SKILL.md
skill-disable/SKILL.md
skill-uninstall/SKILL.md
skill-update/SKILL.md
skill-upload/SKILL.md
skill-market-codex/
.codex-plugin/plugin.json
skills/
skill-market/SKILL.md
skill-list/SKILL.md
skill-search/SKILL.md
skill-download/SKILL.md
skill-install/SKILL.md
skill-disable/SKILL.md
skill-uninstall/SKILL.md
skill-update/SKILL.md
skill-upload/SKILL.md
skills/
INDEX.md
claude/<skill-name>/SKILL.md
codex/<skill-name>/SKILL.md
Claude and Codex plugins are independent. Claude and Codex managed skills are also independent. If the same workflow needs both platforms, publish two variants and keep their manifests and skills separate.
The plugins/skill-market-* directories contain only the bootstrap management skills needed for native plugin installation. Marketplace-managed skills live under the top-level skills/ directory, not inside the bootstrap plugin.
Management skills must not upload, delete, or modify skill-market-claude or skill-market-codex. Bootstrap plugin changes are developer-only repository changes.
Register Marketplace
Claude:
claude plugin marketplace add git@github.com:myqz-wld/skill-market.git
claude plugin install skill-market-claude@skill-market
claude plugin marketplace update skill-market
claude plugin update skill-market-claude@skill-market
Codex:
codex plugin marketplace add git@github.com:myqz-wld/skill-market.git
codex plugin add skill-market-codex@skill-market
codex plugin marketplace upgrade skill-market
For local plugin development only, register /path/to/skill-market instead of the remote URL.
Repository Configuration
~/.skill-market/config.json is the required configuration file: when it is missing, any management skill that reads the remote or cache creates it with the default values before continuing. Environment variables still take precedence over the config file for that run.
The installed management skills use the remote repository as the source of truth:
SKILL_MARKET_REPO_URLenvironment variable.~/.skill-market/config.jsonwith arepoUrlstring.- Default remote:
git@github.com:myqz-wld/skill-market.git.
They use a local cache to avoid fetching the network on every operation:
SKILL_MARKET_CACHEenvironment variable.~/.skill-market/config.jsonwith acachePathstring.- Default cache:
~/.skill-market/cache/skill-market.
For skill-list, skill-search, skill-download, and skill-install, cache freshness is controlled by:
SKILL_MARKET_CACHE_TTL_SECONDSenvironment variable.~/.skill-market/config.jsonwith acacheTtlSecondsnumber.- Default TTL:
86400seconds.
A positive TTL refreshes the cache when the freshness marker is missing or older than the TTL. After clone or fetch, write <cachePath>/.skill-market-cache.json with repoUrl, fetchedAt, and head. Set cacheTtlSeconds to 0 to disable automatic TTL refresh; explicit latest requests still fetch. skill-update and skill-upload always fetch before changing local state or creating PRs.
SKILL_MARKET_REPO or config field repoPath is only an explicit local development override. It is not the default and bypasses cache TTL.
Example config:
{
"repoUrl": "git@github.com:myqz-wld/skill-market.git",
"cachePath": "~/.skill-market/cache/skill-market",
"cacheTtlSeconds": 86400
}
After installation, the management skills are available from the installed plugin namespace:
Claude: /skill-market-claude:skill-market, /skill-market-claude:skill-list, /skill-market-claude:skill-search, /skill-market-claude:skill-download, /skill-market-claude:skill-install, /skill-market-claude:skill-disable, /skill-market-claude:skill-uninstall, /skill-market-claude:skill-update, /skill-market-claude:skill-upload
Codex: skill-market, skill-list, skill-search, skill-download, skill-install, skill-disable, skill-uninstall, skill-update, skill-upload
What the Built-in Skills Do
After installing the plugin, use the management skills to:
- list managed skills from
~/.skill-market/managed-skills.jsonand enrich them with catalog version and status fromskills/INDEX.md - search marketplace plugins and standalone skills
- download plugin or skill packages without installing
- install plugins or standalone skills and record standalone skills in local managed state
- disable Claude plugins and standalone skills without deleting their files
- disable Codex standalone skills without deleting their files; Codex plugin disable is unsupported by the current CLI
- uninstall installed plugins or standalone skills
- update installed plugins or standalone skills
- upload new or updated skills/plugins by creating a branch and PR
Upload is not publish. A skill or plugin is published only after the PR is merged.
skills/INDEX.md is the remote skill catalog index. It records a semver Version for each standalone skill. Start new standalone skills at 0.0.1 and bump the version whenever the published skill package changes. Local management state is stored in ~/.skill-market/managed-skills.json.
skill-download exports packages without installing them. If the user does not provide a destination, use ~/.skill-market/downloads/<adapter>/<name>/.
Local state example:
{
"version": 1,
"skills": [
{
"adapter": "codex",
"name": "example-skill",
"catalogPath": "skills/codex/example-skill",
"installedVersion": "0.0.1",
"activePath": "~/.codex/skills/example-skill",
"disabledPath": "~/.codex/skills.disabled/example-skill",
"status": "installed"
}
]
}
In each entry, activePath is the active install location, disabledPath is the canonical disabled location and may be precomputed while status is installed, and installedVersion records the standalone skill version copied from skills/INDEX.md.
Only skills installed through Skill Market or explicitly adopted by the user are managed. skill-list must not list unrelated local skills. When a requested operation touches a local skill absent from managed-skills.json, ask the user before adopting or modifying it.
Upload Policy
All uploads must go through PR:
- Create branch
market/<type>/<adapter>/<name>. - For plugin uploads, add or update
plugins/<plugin-name>/and the corresponding marketplace catalog. - For standalone skill uploads, add or update
skills/<adapter>/<skill-name>/, bump that skill'sVersioninskills/INDEX.md, and keep the catalog row path/status/description current. - Commit and push.
- Open a PR.
- Merge the PR to publish.
Marketplace deletion follows the same rule: remove or retire the plugin through a PR, then publish only after merge.
See CONTRIBUTING.md.