@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 for Claude that streamline common developer workflows and reduce token usage.
Each skill is a self-contained directory with a SKILL.md, Python implementation scripts, and a test suite — installable directly into Claude Code via the plugin system or via npx.
Quick Start
Option A — Claude Code Plugin (recommended)
Register this repository as a marketplace, then install individual skills or all of them at once:
/plugin marketplace add castastrophe/agent-skills
Install a specific skill:
/plugin install gh-notification-summary@agent-skills
Install everything:
/plugin install agent-skills@agent-skills
Option B — npx one-liner
No clone or install required:
# List available skills
npx @allons-y/agent-skills
# Install a specific skill to ~/.claude/skills/
npx @allons-y/agent-skills gh-notification-summary
# Install all skills
npx @allons-y/agent-skills --all
# Install to a custom directory
npx @allons-y/agent-skills gh-notification-summary --dir ~/my-skills
Option C — Manual
Download the .zip from the npm package or GitHub releases and unzip into ~/.claude/skills/<skill-name>/.
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" |
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();
// [
// {
// name: 'gh-notification-summary',
// path: '/path/to/skills/gh-notification-summary',
// zipPath: '/path/to/skills/gh-notification-summary.zip',
// description: 'Review, summarize, and manage GitHub notifications...',
// mdPath: '/path/to/skills/gh-notification-summary/SKILL.md'
// }
// ]
Development
Prerequisites
- Node.js (v24), supports
nvm use
- Yarn
- uv (Python package manager — handles Python version and dependency management)
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 — including Python virtual environments, running tests, linting, evals, and publishing — see CONTRIBUTING.md.
Project Structure
agent-skills/ # Root workspace (publishes to npm)
├── package.json # workspaces: ["skills/*"]
├── index.js # Exports getSkills()
├── bin/install.js # npx installer CLI
├── scripts/ # Root orchestration scripts
│ ├── run-tests.js # Parallel pytest runner
│ ├── bundle-skills.js # Zips skills for distribution
│ ├── generate-agent-yaml.js # Generates agent.yaml
│ └── generate-plugin-manifest.js # Generates marketplace.json
├── skills/ # Yarn workspace members
│ └── <skill-name>/ # Each skill is a workspace
│ ├── package.json # private: true, skill-level scripts
│ ├── pyproject.toml # mypy config
│ ├── requirements.txt # Python dependencies
│ ├── SKILL.md # Metadata and usage docs
│ ├── scripts/ # Python implementation
│ ├── tests/ # pytest suite
│ └── evals/ # Eval prompts (evals.json)
└── .github/
└── workflows/ # CI and release automation
FAQ
What's inside a skill .zip file?