mdskill

CLI to browse, search, and pull agent skills (pre-built prompt/instruction files) into your project under .skills/. Sign in with an API key (browser flow); some skills are free, others need a paid subscription.

Installation

npm install -g mdskill

Quick start

mdskill login
mdskill list
mdskill add <slug>

Use mdskill search <query> to find skills by keyword (minimum 2 characters).

Commands

| Command | Description | | --- | --- | | mdskill login | Opens the browser to sign in and saves your API key locally. | | mdskill logout | Signs out and removes the local API key. | | mdskill whoami | Shows the currently logged-in user. | | mdskill list | Lists all available skills (name, type, description). | | mdskill search <query> | Search skills by keyword (min 2 chars). | | mdskill add <slug> | Downloads a skill into .skills/<slug>/ in the current project. Auto-adds .skills/ to .gitignore if it is not already there. Shows a premium upgrade prompt if the skill requires a subscription. | | mdskill info <slug> | Shows metadata for a specific skill (name, description, type, path, audit status, etc.). |

Skill types

• Public — Free skills anyone can use after login.
• Premium — Require a paid subscription; mdskill add will prompt you to upgrade when needed.

.skills/ folder

Skills are written under .skills/<slug>/ in your project. If .gitignore exists and does not yet list .skills/, the CLI appends that entry so skill files are not committed by default.

Requirements

• Node.js >= 20

Documentation

• Docs: https://mdskill.dev/docs
• Upgrade (premium): https://mdskill.dev/upgrade

License

MIT