skillmds

Agent Skills are Markdown-Dateien (SKILL.md), die KI-Agenten neue Arbeitsabläufe beibingen. SkillMD ist die Registry, die lintet: Jede Fähigkeit wird validiert, sicherheitsgeprüft und inhaltlich gepinnt – und dierses Repository ist die Werkzeugkette, die das erledigt: dieselbe Engine auf Ihrem Rechner und in der Registry.

The 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 hat es automatisch auf 68 Agenten abgesehen – Claude Code, Cursor, Codex, Windsurf, Gemini CLI, GitHub Copilot, Cline, Gooose, Zed und wewn – und sch et hierbei jede Fähigkeit in jeden ongzuuge er erkanannten Agenten on oner Die Eigeneug-Verzeichnis-Konvension konformt. Schon skillmd öffnet ein geführtes interaktives Menü.

Vollständige Referenz: docs/cli.md

Related MCP server: ThirdBrain skills-mcp

Der MCP-Server

Geben Sie jedem MCP-fähigen Ahenten thegen gesamten Registry – um Fähigkeiten mitten am on im Geprä räch zu suchen, inspissezieren, linte en on installieren en:

# 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"] } } }

Oder verwenden Sie die hosteten Remote-Server – keine Install ation, streamable HTTP:

https://api.skillmd.com/mcp

| Tool | Was der Ahent erhält | | ---------------------------------------- | ------------------------------------------------- ---------------- | | skillmd_search | Registry-Suche mit Kategorien, Bewertungen und Install-Snippets | | skillmd_get | Vollständige Skill-Details: Inhalt, Herkunft, Lizen und Sicherheitsflags | | skillmd_install | Sichere Instllation: validiert, ShA-256-verifiziert, Zip-Slip-Geschützt, führt nie Skripts aus | | skillmd_trending / skillmd_recomend | Rangliste + Vorschläge für ähnche Skills | | skillmd_list_seved | Ihre gespeicherten Skills (mit SKILLMD_TOKEN) | | skillmd_lint | Valisieren Sie jeden SKILL.md-Inhalt sofort |

Vollständige Referenz: docs/mcp.md · Registry-Eintrag: com.skillmd/skillmd

Die Engine

npm i @skillmd/core

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

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

Neun Lint-Regel, ein zeilenbewusster Sicherheitscaner (network_calls, executes_cripts, reads_secrets, …), eine 0–100-Qualitätscore und 100SARIF/JSON/JGitHub- annotationsformat. ESM, typisiert, keine In-time-Abhängigkeit außererm yaml, läuft in Node.js/Browser/Kante. Regeln: docs/rules.md

CI für die Skills

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

Lintet jede Fähigkeit im Repo and ldadt SARIF zu GitHub Code Scan high hoch – Egebnisse erschein directly – direkt in PRs. Völlständiges Besipel: examples/github-action.yml

Die Registry-API

Alles hier is deün dünner Clit über die öffentliche API at api.skillmd.com – direct uletzer (GET /v1/search?=…), beschrieben in docs/registry-api.md, https://skillmd.com/openapi.json und https://skillmd.com/llms.txt.

Sicherheitsmodell

Das Installieren eines Skills dagegen schreibt Dateien und sonst nichts: einer Skriptausführung, starke Pfa -Eingrenzung (Slug Validierung + Zip-Slip-Sütz), Sha-256-Integritätspyun gegen die inhriekt adriierten Store der Registry sowie zugeordnete Downloads die auf GitHub-Raw-Hosts ge pinntd. Details in SECURITY.md – Sicherheitsmeldungen an <(hi@skillmd.com)>.

Entwicklung

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

Siehe CONTRIBUTING.md für Struktur, PR-Richtlinien und den Release-Prozess.

Lizeniz

MIT © SkillMD