agent-skills

@allons-y/agent-skills

[![CI][workflow-image]][workflow-url] [![npm][npm-image]][npm-url] [![Coverage][coverage-image]][coverage-url] [![Conventional Commits][conventional-commits-image]][conventional-commits-url]

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

Each skill is a self-contained directory with a SKILL.md, Node.js implementation scripts, and a test suite. Claude Code installs natively via the plugin marketplace; other agent harnesses can vendor any skill directory via npx.

Quick Start

Claude Code (recommended)

Register this repository as a marketplace, then install individual skills through the /plugin UI:

/plugin marketplace add Allons-y-Studio/agent-skills
/plugin install gh-notification-summary@agent-skills

Claude Code clones the repo, mounts each skill directory, and surfaces them under /plugin for enable/disable.

Other agent harnesses (Cursor, OpenCode, Aider, custom SDK)

Use the npx installer to vendor a skill directory into any agent's skill folder. The installed payload is a plain directory with SKILL.md + scripts — no Claude-specific wiring.

# List available skills
npx @allons-y/agent-skills

# Install a skill to the default location (~/.claude/skills/)
npx @allons-y/agent-skills gh-notification-summary

# Install to your agent's skill directory
npx @allons-y/agent-skills gh-notification-summary --dir ~/.config/cursor/skills

# Install all skills
npx @allons-y/agent-skills --all

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

Note: .zip-based distribution is deprecated and will be removed in the next major version. The installer now copies the skill directory directly.

Available Skills

Skill	Description	Trigger
gh-notification-summary	Review, summarize, and manage GitHub notifications via an interactive local dashboard	"check my GitHub notifications", /unsub <number>, "mark all done"
design-system	Build, name, document, and audit UI components with expert ARIA, accessibility, design token, typography, and i18n guidance	"design system", "component library", "ARIA pattern", "what should I call this component", "review my component library"
dreamlight-valley	Navigate, search, and browse the Dreamlight Valley catalog of items, recipes, and gatherables	"Dreamlight Valley", "Dreamlight Valley catalog", "Dreamlight Valley recipes", "Dreamlight Valley gatherables"

Programmatic Usage

The package exposes a getSkills() helper for tool builders who want to list or load skills dynamically:

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

const skills = getSkills();
// returns =>
// [
//   {
//     name: 'gh-notification-summary',
//     path: '/path/to/skills/gh-notification-summary',
//     description: 'Review, summarize, and manage GitHub notifications...',
//     mdPath: '/path/to/skills/gh-notification-summary/SKILL.md'
//   },
//   {
//     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'
//   }
// ]

Development

Prerequisites

• Node.js (v24), supports nvm use
• Yarn 4 (via Corepack)

Installation

yarn install

Workspace commands

This is a Yarn workspaces monorepo — each skill under skills/ is its own workspace. Target a specific skill with yarn workspace:

yarn workspace @allons-y/skill-gh-notification-summary test
yarn workspace @allons-y/skill-gh-notification-summary lint

Or run across all skills at once:

yarn workspaces foreach -A run test

For full setup instructions — running tests, linting, evals, and publishing — see CONTRIBUTING.md.

Project Structure