docs
What you can ask
Talk to your agent in plain words. It picks the right skill-sets tool. These prompts show what works well.
Find skills for a task
- “Find skills that help me write Playwright end-to-end tests.”
- “What skills are there for deploying to Cloudflare Workers?”
- “I review a lot of pull requests. Is there a skill for that?”
Describe the task, not a single keyword. You get up to 10 skills by default, ranked by how well they match. Each skill has a short description, its source, its install count and a security audit result. A skill that is copied under many owners shows once.
Look at one skill
- “Tell me more about the first result.”
- “Show me the full SKILL.md of that skill.”
- “Find skills similar to this one.”
The agent reads the record of the skill: what it does, where it comes from, and its audit. It can also read the full skill text, which costs one more call. A similar-skills request returns the nearest skills in the directory.
Compare skills
- “Compare the top three skills for writing release notes. Which one do most people install?”
- “Which of these skills have security warnings?”
The agent reads each skill and puts them side by side. It reports install counts, sources and audit results. A skill with a warning or no audit is shown as a caveat.
Build a skill-set for a goal
- “Build me a skill-set for shipping a Next.js app: testing, deploys and code review.”
- “Make a skill-set from the skills we just picked. Call it frontend-quality.”
The agent searches for each part of the goal, picks skills, and makes a .skill-set.json manifest. It also tells you which skills can be pinned to a fixed version. A draft is not stored anywhere until you ask for a link.
Install or share a set
- “Save the manifest and install the set in this project.”
- “Make a share link for this set.”
- “Submit this set to the skill-sets.md directory.”
The agent installs a set with the skill-set CLI, for examplenpx @skill-set/cli add ./frontend-quality.skill-set.json. A share link stays live for 30 days after its last use, and anyone with the link can install the set. A submission sends the set for review in the public directory. It needs a GitHub sign-in, and the agent submits only after you approve it.
Give feedback on a skill
- “That skill worked well for me. Record a review.”
- “Answer a skill-sets assessment to earn more calls.”
A review records your opinion of a skill you chose. It needs a sign-in and earns no calls. An assessment is a short task about a skill that the server picks, and it earns calls. Read Credits, sign-in and assessments.