What do you want to do?
5 use cases
-
Lint a SKILL.md file before you share it
Run the same checks the registry uses and fix format problems before a skill goes public.
- Skillmd
- Software and DevOps
- Intermediate
View prompt
Use the skillmds repo to lint the skill at <path-to-skill-folder> by running `skillmd lint <path-to-skill-folder>`. Return the diagnostics and the 0 to 100 quality score. Verify that the command exits without errors before reporting the result.
-
Check every skill in a repo on each pull request
Add a GitHub Action that lints all skills and posts results to GitHub Code Scanning.
- Skillmd
- Software and DevOps
- Intermediate
View prompt
Add the skillmds/skillmd/action@v1 step with path set to '.' to the CI workflow in <repo-path>, using examples/github-action.yml from the skillmds repo as the template. Confirm the workflow file is valid YAML and report which skills the action lints.
-
Find a skill and install it into every local agent
Search the registry from the terminal and install a skill into each detected agent.
- Skillmd
- Software and DevOps
- Intermediate
View prompt
Use the skillmds CLI from the skillmds repo to search the registry for <search-term>, then install <owner/skill> with `npx skillmds add <owner/skill>`. Report which agent directories received the skill and verify the files exist there.
-
Let your coding agent search and install skills mid-task
Connect the skillmds MCP server so an agent can search, inspect, lint and install skills itself.
- Skillmd
- Claude Code
- Cursor
- Software and DevOps
- Intermediate
View prompt
Connect the skillmds MCP server from the skillmds repo to <client-name> using `npx -y skillmds`. Ask it to search the registry for <topic> and to lint the result with skillmd_lint. Report the skill it chose and confirm the install returned without running scripts.
-
Publish a linted skill to Skillmd.com
Dry-run and publish a skill to the registry, with publishing blocked on lint errors.
- Skillmd
- Software and DevOps
- Intermediate
View prompt
Use the skillmds CLI from the skillmds repo to lint <path-to-skill> and then run `skillmd publish <path-to-skill> --dry-run`. Report any lint errors and the dry-run output. Verify that the dry run succeeds before running the real publish.
How to use Skillmd
- Check you have what it needs: Node.js with npm, since the README uses npm and npx commands; A terminal on your machine or in CI; A skill folder containing a SKILL.md file (for lint and publish use cases).
- Open skillmds/skillmd on GitHub and read the README and license.
- Install the tools with
npm i -g skillmds, or skip the install and use thenpxform below. - Run
npx skillmds lint ./my-skillon the folder that contains your SKILL.md. - Read the diagnostics and quality score, then run
skillmd lint . --fixto apply the mechanical fixes. (inferred, check the README) - Run
skillmd lint . --strictso warnings also fail the check before you share the skill.
These steps come from our top use case, Lint a SKILL.md file before you share it, which also has a copy-paste agent prompt.
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeSkillmd alternatives · Best AI repos for Software and DevOps
About this repo
- Who it is forSkill authors, developers who want reusable agent instructions, and teams that keep skills in git and want them checked in CI.
- Why it is hot
- LanguageJavaScript
- Sourcegithub.com/skillmds/skillmd · Back to Hot repos
Requirements
- Node.js with npm, since the README uses npm and npx commands
- A terminal on your machine or in CI
- A skill folder containing a SKILL.md file (for lint and publish use cases)
- A skillmd.com account and token (only for publishing)
Add this badge to your README
Maintain Skillmd? Show readers where to find these use cases.
Markdown
[](https://dedupedai.com/use-cases/skillmds-skillmd/?utm_source=github&utm_medium=badge&utm_campaign=skillmds-skillmd)
HTML
<a href="https://dedupedai.com/use-cases/skillmds-skillmd/?utm_source=github&utm_medium=badge&utm_campaign=skillmds-skillmd"><img src="https://dedupedai.com/badge/skillmds/skillmd.svg" alt="Use cases on Deduped" height="20"></a>
A static image, no tracking script. About the badge
Questions about Skillmd
What is Skillmd?
SkillMD is an open-source toolchain (CLI, MCP server, GitHub Action and lint engine) for searching, installing, linting and publishing Agent Skills (SKILL.md files) across many coding agents. It is an open-source project on GitHub: https://github.com/skillmds/skillmd.
Who is Skillmd for?
Skill authors, developers who want reusable agent instructions, and teams that keep skills in git and want them checked in CI.
What can I do with Skillmd?
5 use cases so far, for example: Lint a SKILL.md file before you share it; Check every skill in a repo on each pull request; Find a skill and install it into every local agent. Each has steps and a copy-paste agent prompt.
What do I need to run Skillmd?
Node.js with npm, since the README uses npm and npx commands; A terminal on your machine or in CI; A skill folder containing a SKILL.md file (for lint and publish use cases); A skillmd.com account and token (only for publishing).
What are alternatives to Skillmd?
Other hot AI repos in Software and DevOps: Omarchy Local AI, Hermes Plan Mode, Agent 2, Agnes Harness, Skills.
Is Skillmd safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.