convez.ai
SkillIntegração & APIsAvançado
myqz-wld

Skill Market

myqz-wld/skill-market

Marketplace de skills nativo para Claude e Codex com gestão integrada

Ver no GitHub
InicialPluginScore · de 0 a 100

Marketplace 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-market

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 semanas
Versão
—
Issues abertas
0
Contribuidores
1

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:

  1. SKILL_MARKET_REPO_URL environment variable.
  2. ~/.skill-market/config.json with a repoUrl string.
  3. Default remote: git@github.com:myqz-wld/skill-market.git.

They use a local cache to avoid fetching the network on every operation:

  1. SKILL_MARKET_CACHE environment variable.
  2. ~/.skill-market/config.json with a cachePath string.
  3. Default cache: ~/.skill-market/cache/skill-market.

For skill-list, skill-search, skill-download, and skill-install, cache freshness is controlled by:

  1. SKILL_MARKET_CACHE_TTL_SECONDS environment variable.
  2. ~/.skill-market/config.json with a cacheTtlSeconds number.
  3. Default TTL: 86400 seconds.

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.json and enrich them with catalog version and status from skills/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:

  1. Create branch market/<type>/<adapter>/<name>.
  2. For plugin uploads, add or update plugins/<plugin-name>/ and the corresponding marketplace catalog.
  3. For standalone skill uploads, add or update skills/<adapter>/<skill-name>/, bump that skill's Version in skills/INDEX.md, and keep the catalog row path/status/description current.
  4. Commit and push.
  5. Open a PR.
  6. 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.

Ver o original no GitHub

Bom para

Relacionados