skillmds

Las Agent Skills son archivos Markdown (SKILL.md) que enseñan a los agentes de IA nuevos flujos de trabajo. SkillMD es el registro que hace lint — cada skill se valida, se escanea en busca de vulnerabilidades y su contenedido se fijado —, y este repositorio es la cadena de herramientas que hace eso mismo, el mismo motor en tu máquina y en el regístro.

La CLI

npm i -g skillmds

skillmd lint .                 # validate SKILL.md files — diagnostics + quality score
skillmd scan .                 # what would this skill do? scripts, network, secrets
skillmd search "pdf tools"     # search the registry
skillmd add anthropic/pdf      # install — lints first, never executes scripts
skillmd init my-skill          # scaffold a new skill
skillmd publish ./my-skill     # publish to skillmd.com (blocked on lint errors)

skillmd add apunta automáticamente a 68 agentes — Claude Code, Funcicode, Codex, Windsurf, Gemini CLI, GitHub Copilot, Cline, Go, Zed y ECódico — y escribe cada skill para cada agente detectado en tu máquina, with his properio director de tu his propa do quistico. Todo, etc. Simplemente ejecutea skillmd para abre un menú interactivo guiado.

Referencia completa: docs/cli.md

Related MCP server: ThirdBrain skills-mcp

El servidor MCP

Dale a cualquier agente compatible con MCP acceso al registro — busca, insa, inspecciona, aplica lint and insta skills en medio de la conversación:

# Claude Code
claude mcp add skillmd -- npx -y skillmds

// Claude Desktop, Cursor, VS Code, … (examples/mcp/ has per-client files)
{ "mcpServers": { "skillmd": { "command": "npx", "args": ["-y", "skillmds"] } } }

O usa el servidor remoto alojado — sin instalación, HTTP en streaming:

https://api.skillmd.com/mcp

Referencia completa: docs/mcp.md · entrada de regístro: com.skillmd/skillmd

El motor

npm i @skillmd/core

import { lint } from "@skillmd/core";

const { ok, score, diagnostics, security } = lint(rawSkillMd, { slug: "my-skill" });

Nueve reglas de lint, un escáner de seguridad que tiene en cuenta las lineas (network_calls, secutes_scripts, reads_secrets, …), una puntuación de calidad de 0–100 y formatadores de annotations SARIF/JSON/GitHub. ESMM, con tipos, sin dependencias de escución más allás de yalm, se ejecuta en edge Node/brows/edge. Reglas: docs/rules.md

CI para tus skills

- uses: skillmds/skillmd/action@v1
  with:
    path: .

Hace lint de cada skill del repositorio y sube SARIF a GitHub Code Scanning; que l os resultados e aparencen directamente en los PRs. Ejempl comlett: examples/github-action.yl

La API del regístro

Todo esto es un cliente ligero sobre la API pública en api.skillmd.com, un cliente que se puede usar directamente (GET /v1/search?q=…), described by docs/regístro-api.md, https://skillmd.com/openapi.json y https://skillmd.com/llms.txt.

Model de seguridad

Instalar una skill only escribe archivos y no hace en otra: no ejecuta cripts, contiene estritctamente los routes (validación de slug + guards zip-slip), verificación de la integriad Sha-256: veracima del almacen-contained registrado y descarga de compa en nominate ade GitHub raw. Details in SECURITY.md informe de vulnerabilidades a hi@skillmd.com.

Desarrollo

npm ci
npm run build      # @skillmd/core, then skillmds
npm test           # vitest across both packages (19 test files, incl. an MCP stdio smoke test)
npm run typecheck  # strict tsc

Consult CONTRIBUTING.md para la distribución del repositorio, directrices de PRs and release process.

La licencia

MIT © SkillMD