Skip to main content

Skills

Skills are the intent router below the SOP. The SOP says "load the matching skill"; each skill says what to do for that intent.

SliceCovers
Review and deliveryreviews, GitHub, PR/issue text, communication
Repo workflow and code intelligencegit/worktrees, semantic tools, clone research, cleanup scanners
Elastic and Kibanadomain overlay, Buildkite, labels, ownership, backports, kbn-standup
External tools and mediaGoogle Workspace, flights, browser control, image generation

Entry contract

Every skill should make four things obvious near the top:

FieldPurpose
Use whenrouting triggers
Do not useboundaries and escalation
First actionsmandatory first probes or skill loads
Outputexpected deliverable

The description frontmatter is the primary routing signal. For non-manual skills, include the concise Use when trigger there; the body is only available after routing has already loaded the skill. Body Use when blocks may stay as detailed post-load applicability checks, but no routing trigger should exist only in the body. Keep descriptions specific, include non-obvious trigger words, and state repo/org constraints when a skill is gated.

Source map

SurfacePath
Sourcehome/exact_dot_agents/exact_skills/
Target~/.agents/skills/
EntrypointSKILL.md in each skill folder
Referencesoptional references/ under the skill folder

Cross-skill hygiene

  • Composition skills sanitize public GitHub text before drafting or posting.
  • k-compose-pr, k-compose-issue, and k-github reuse review's GitHub context intake when output depends on existing PR/issue/comment context.
  • Generic skills own portable mechanics only. If a rule names an org, repo, product, team, label, bot login, CI instance, PR template, live-UI target, ownership policy, or release-note/backport rule, put it in a verified domain overlay or dedicated domain skill.
  • Generic skills may dispatch to a domain overlay after verifying the target; they must not inline Elastic/Kibana or other domain defaults.
  • GitHub issue worktrees prefer ,gh-worktree issue <owner/repo> <issue_number> --branch <branch-base-name>.

Credits

Four skills are adapted from Matt Pocock's mattpocock/skills (MIT-licensed). Attribution lives here rather than inline in each SKILL.md so it does not consume model context when the skill loads.

SkillAdapted from
k-writing-great-skillsk-writing-great-skills
k-codebase-designk-codebase-design
k-diagnosing-bugsk-diagnosing-bugs
k-prototypek-prototype