convez.ai
SkillIntegração & APIsIntermediário
specscore

SpecScore AI Plugin

specscore/ai-plugin-specscore

Wrapper de CLI SpecScore para agentes de IA — navegação e linting de specs

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin que integra a CLI SpecScore com agentes de IA (Claude Code, Codex, Gemini, GitHub Copilot e Cursor), fornecendo skills para navegação, linting e operações de ciclo de vida de especificações. Funciona como wrapper que ensina agentes quando e como invocar comandos SpecScore.

Instalação

$npx convez-ai specscore/ai-plugin-specscore

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
50%
Último commit
há 1 mês
Versão
specscore--v0.0.8
Issues abertas
0
Contribuidores
2

Casos de uso

  • Linting e validação automatizada de especificações técnicas via agentes
  • Navegação e exploração de specs complexas com assistência de IA
  • Automação de operações de ciclo de vida de documentação técnica

Veredito

Plugin bem estruturado que democratiza acesso a SpecScore via múltiplos agentes de IA. Requer CLI instalada e é mais útil para equipes que já trabalham com specs estruturadas; curva de aprendizado moderada mas valor operacional claro em automação de validação.

README

A tradução para o português deste README ainda está na fila.

SpecScore AI Plugin

AI plugin for SpecScore — skills that teach AI agents how to use the specscore CLI for spec navigation, linting, and lifecycle operations.

This repository contains the plugin source. It is installed on top of the specscore CLI; the CLI is a prerequisite.

Contents

DirectoryDescription
skills/Agent skills — one per SpecScore CLI resource group, progressively loaded per-verb
.claude-plugin/Claude Code plugin manifest
.codex-plugin/Codex plugin manifest
gemini-extension.jsonGemini CLI extension manifest
.github/plugin.jsonGitHub Copilot CLI / VS Code agent plugin manifest

Install

The same skills/<name>/SKILL.md payload is shared across all agents — only the manifest each agent reads differs.

Claude Code

Via the SpecScore AI marketplace:

/plugin marketplace add specscore/ai-marketplace
/plugin install specscore@specscore

Requires Claude Code v2.1.110 or later if installed transitively as a dependency of another plugin.

Codex

codex plugin marketplace add specscore/ai-marketplace

Then enable the specscore plugin from Codex's plugin directory. (Codex has no codex plugin add subcommand; installation happens through the plugin directory after the marketplace is added.) Codex reads .codex-plugin/plugin.json.

Gemini CLI

gemini extensions install https://github.com/specscore/ai-plugin-specscore

Gemini reads gemini-extension.json and auto-discovers the bundled skills/ tree.

GitHub Copilot CLI

copilot plugin install specscore/ai-plugin-specscore

Copilot reads .github/plugin.json.

Cursor

Cursor has no remote-install command — it loads skills from .cursor/skills/ (project) or ~/.cursor/skills/ (global). Add these skills by copying them in:

git clone https://github.com/specscore/ai-plugin-specscore
mkdir -p .cursor/skills && cp -R ai-plugin-specscore/skills/* .cursor/skills/

First use

The specscore CLI must be on your PATH before any wrapper skill can run. Two options:

  • Invoke specscore:install inside your AI agent — the install skill shows the official installer options.
  • Or run manually in your terminal: curl -fsSL https://specscore.md/get-cli | sh.

Verify with specscore --version.

Relationship to the CLI

The plugin wraps the specscore CLI — it does not replace it. Skills encode when to call a command, which flags to pass, and how to interpret exit codes. The CLI contract (commands, flags, exit codes) is defined in specscore/specscore-cli.

A change in the CLI surface typically produces a matching skill update in this repository; the two evolve together but release independently.

Relationship to other plugins

specscore is a base-layer CLI wrapper plugin. Methodology plugins such as specstudio depend on it to compose multi-step workflows. See ADR-0004 for the full layering rationale.

Sister plugin: synchestra-cli — wraps the synchestra CLI using the same structure.

Releases

Releases are tagged as specscore--v<version> on this repository to support Claude Code's dependency resolution. See ADR-0004 for the convention.

License

MIT — see LICENSE.

Open Questions

None at this time.

Ver o original no GitHub

Bom para

Relacionados