BC Gov Agent Skills
A shared catalogue of agent skill profiles
Open Source

BC Gov Agent Skills

A shared catalogue of agent skill profiles for the BC Government: validated in CI on every PR, installable into any compatible agent with one npx skills add command.

Each skill is a SKILL.md manifest bundled with any helper scripts, references, or assets it needs. Every change goes through a pull request and runs through the validator; once a PR merges, the next npx skills add picks it up — no registry, no auth token, no version metadata to maintain.

What is a "skill"? A small, focused Markdown document that teaches an AI coding agent when to act, what to do, and what to avoid. The format is interoperable with GitHub Copilot, Claude, and other agents that load SKILL.md manifests; see agentskills.io and our spec.

Where do you want to start?

I want to use a skill

Install a skill into Copilot, Claude Code, Cursor, Cline, or any other agent that loads SKILL.md. One command: npx skills add bcgov/agent-skills picks the target agent, copies the skill folder into the right place, and you're done.

Consume guide →

I want to add a skill

Scaffold from the template, write the seven required sections, run make validate, open a PR. Merge makes it installable.

Contribute guide →

I want to know how it works

PR validation, branch protection, signed commits, fork gating, Dependabot auto-merge: how the controls actually fit together.

Pipeline & governance →

The catalogue at a glance

Public skills

Everything under skills/ is the public catalogue. Install one with npx skills add bcgov/agent-skills --skill <name>, or grab the lot with npx skills add bcgov/agent-skills.

There is no version metadata to maintain: the merge-to-main state of this repo is the released state, so the catalogue is always as fresh as the last green PR.

Browse the catalogue page →  ·  View skills/ on GitHub

Meta-skills

Skills that operate on this repo itself: scaffolding a new skill and validating the spec. Validated against the same spec, but they live inside the repo for agents working in a checkout rather than being part of the public catalogue.

See the meta-skills in the catalogue →  ·  Browse .github/skills/ in the repo →

Why BC Gov runs its own catalogue

The most useful agent skills are specific: they encode a concrete policy, an internal service, or a known-good workflow. Generic catalogues already cover the generic ground (see the upstream catalogues we check before adding anything here). This repo only ships skills that are BC Gov–specific: skills that capture our Public Cloud Landing Zone rules, our policies, our subscription topology, and the workflows our teams have already paid the cost of figuring out.

Knowledge worth sharing

When a team figures out how to do something within BC Gov constraints, that should live in a skill instead of a Confluence page nobody finds. The next team starts from a working answer rather than another fresh investigation.

Validated releases, no silent updates

Every change runs through the same validator before it can merge, so the catalogue stays consistent. Consumers pull updates explicitly when they re-run npx skills add — nothing in the agent's environment changes without that command.