Skills for AI agents

@allons‑y/agent‑skills

Specialized agent skills that streamline common developer workflows and reduce token usage.

Get started View on GitHub

CI build status Latest npm version Weekly npm downloads Test coverage threshold Requires Node.js 24 or newer Conventional Commits 

/plugin marketplace add allonsy-studio/agent-skills
/plugin install design-system@agent-skills

What is an agent skill? #

Agent skills are focused, self-contained capability packs you can drop into an AI coding agent. Each skill bundles a SKILL.md (the prompt and trigger description), a Node.js implementation (where applicable), and a robust test suite — all under one directory.

Claude Code installs them natively via the plugin marketplace. Other agent harnesses — Cursor, OpenCode, Aider, or anything built on the Claude Agent SDK — can vendor any skill directory with one npx command. No vendor lock-in.

Featured skill

Design Reference Tested

Build, name, document, and audit UI components with expert ARIA, accessibility, design token, typography, and i18n guidance written by a Staff engineer with experience building design systems at scale.

Read the docs

Built to be trusted #

These aren't prompt snippets pasted from a gist. Every skill is engineered, tested, and maintained like production software.

Expert-written

Every SKILL.md prompt is hand-authored by domain experts — not auto-generated boilerplate.

Fully tested

Each skill ships a node --test suite with c8 coverage, so behavior is verified, not assumed.

Linted & formatted

ESLint and Prettier run on every commit for consistent, reviewable code.

Eval-backed

LLM eval suites check that each skill triggers and behaves correctly on real prompts.

CI on every change

Tests, linting, and evals run in GitHub Actions before anything merges to main.

No vendor lock-in

Plain SKILL.md directories — install natively in Claude Code or vendor into any harness.

Available skills #

All skills currently published in this marketplace.

design-system

Design Reference Tested

Build, name, document, and audit UI components with expert ARIA, accessibility, design token, typography, and i18n guidance written by a Staff engineer with experience building design systems at scale.

Triggers: "design system" "component library" "ARIA pattern" "what should I call this component" "review my component library"

Learn more

dreamlight-valley

Games Implementation Tested Live preview

Cooking, gathering, and inventory management for Dreamlight Valley.

Triggers: "/cook <flags> <ingredients>" "/restock <flags>" "/recipe <dish name>" "any request related to the video game Dreamlight Valley"

Learn more

gh-notification-summary

GitHub Implementation Tested

Review, summarize, and manage GitHub notifications via an interactive local dashboard. Unsubscribe from noisy threads, mark individual notifications or your whole inbox as done, all from a single prompt.

Triggers: "check my GitHub notifications" "/unsub <number>" "mark all done" "clear my GitHub inbox" "any request to triage, dismiss, or act on GitHub notifications"

Learn more

structured-data

SEO Implementation Tested

Inject or generate schema.org structured data (HTML Microdata or JSON-LD) into web markup, then validate it. Picks the right format per project, injects at build/server-render time only, and emits a reviewable diff...

Commands: /preview-structured-data

Triggers: "add schema.org markup" "add structured data / rich snippets / SEO markup" "add JSON-LD to this page" "add itemprop/itemscope/itemtype attributes" "validate, audit, or fix my structured data" "should I use Microdata or JSON-LD"

Learn more

Install #

Pick the card for your agent harness. Every install uses the same skill payload — there's no Claude-specific wiring inside SKILL.md.

Claude Agent SDK

Vendor with npx

Drop any skill into your agent's SKILL.md directory. No Claude-specific wiring.

npx @allons-y/agent-skills design-system --dir ~/.claude/skills

Cursor

Vendor with npx

Cursor reads skill folders from your project. Vendor the skill, then point Cursor at it.

npx @allons-y/agent-skills design-system --dir .cursor/skills

Any other harness

Pick your own directory

Aider, OpenCode, or anything that reads SKILL.md directories. Choose your target folder.

npx @allons-y/agent-skills --list
npx @allons-y/agent-skills design-system --dir <your-skills-dir>

For Node-runtime skills with dependencies, run npm install in the vendored directory once.

Programmatic usage #

Tool builders can enumerate skills dynamically via the exported getSkills() helper.

import { getSkills } from "@allons-y/agent-skills";

const skills = getSkills();
// returns =>
// [
//   {
//     name: "design-system",
//     path: "/path/to/skills/design-system",
//     description: "Build, name, document, and audit UI components...",
//     mdPath: "/path/to/skills/design-system/SKILL.md",
//   },
//   ...
// ]

Contributing #

New skills, improvements, bug fixes, and documentation are all welcome. See CONTRIBUTING.md for environment setup, the test/lint/eval workflow, and the PR checklist.

Some ideas if you're looking for a starting point:

  • GitHub PR review summarizer
  • Linear / Jira issue triage
  • Slack digest summarizer
  • Daily standup generator from git log
  • Accessibility audit runner (pairs nicely with design-system)