Skills

Agent skills for GitHub Copilot and other coding agents, built following the agentskills.io specification and publishable via skills-npm.

Available Skills

| Name | Description | | ---- | ----------- | | shields-badges | Analyse a repository to identify its focus and technology stack, then apply appropriate shields.io badges to markdown files. | | writing-skills | Author high-quality agent skills following the agentskills.io specification, with correct frontmatter, workflow structure, and reference assets. | | publishing-npm | Prepare and publish an npm package that ships agent skills, following the skills-npm convention for skill bundling and distribution. | | github-gist | Create, manage, and organize GitHub Gists using the gh and CLI. |

Usage

Via npm (Recommended)

Install the package and symlink the bundled skills using skills-npm:

npm install @abuxton/skills
npx skills-npm

To symlink skills automatically on every npm install, add a prepare script to your package.json:

{
  "scripts": {
    "prepare": "npx skills-npm"
  }
}

skills-npm creates symlinks at skills/npm-<package-name>-<skill-name> in your project. Add this to your .gitignore to avoid committing them:

skills/npm-*

Manually

Copy a skill folder to your local skills/ directory and reference it in your Copilot prompts, or let the agent discover it automatically.

Each skill folder contains a SKILL.md instruction file and optional bundled reference assets.

Contributing

See AGENTS.md for guidance on writing new skills and publishing them via npm.