Files
gitadmin 01c488157d docs: rewrite repo indexes and context pack for skills/ layout
Replace the stale common/ structure docs with the current skills/ bucket
layout. Root and bucket READMEs now index every SKILL.md by invocation
type, AGENTS.md lists the ten actual buckets, and the project context
pack is condensed to purpose, structure, conventions, and validation.
2026-10-06 14:00:45 -04:00

2.1 KiB

Steve Beaulac Skills

A collection of agent skills (slash commands and behaviors) loaded into AI coding agents. Skills live under skills/, grouped by purpose; each bucket README and the root README index its SKILL.md files by invocation type.

Skill buckets

  • engineering/ — daily code work
  • in-progress/ — drafts not yet ready to ship
  • misc/ — kept around but rarely used
  • personal/ — tied to the user's own setup, not promoted
  • pkm/ — personal knowledge management
  • pstack/ — personal agent workflow skills
  • productivity/ — general workflow tools
  • setup-skills/ — one-time repository setup skill and its references
  • skill-authoring/ — create and maintain agent skills
  • thinking-and-docs/ — decisions and documentation workflows

Each bucket folder has a README.md that lists every skill in the bucket with a one-line description, with the skill name linked to its SKILL.md. Bucket README.mds and the top-level README.md group entries into User-invoked and Model-invoked.

Every SKILL.md is either user-invoked (disable-model-invocation: true, reachable only by the human) or model-invoked (model- or user-reachable). For the full definitions, description conventions, and why a user-invoked skill can invoke model-invoked skills but never another user-invoked one, see docs/invocation.md.

Agent skills

Issue tracker

Issues are tracked in Gitea on gitea.sagacity.ca. See docs/agents/issue-tracker.md.

Triage labels

Seven-label vocabulary with default names (needs-triage, needs-info, needs-review, ready-for-agent, ready-for-human, in-progress, wontfix). See docs/agents/triage-labels.md.

Domain docs

Single-context layout. See docs/agents/domain.md.

ADR wiki

Gitea wiki at git@gitea.sagacity.ca:steve/Skills.wiki.git, cloned into docs/adr/, SSH key auth. See docs/agents/adr-wiki.md.

Project Context Pack

Agent memory file that describes the repo's context, codebase, and navigation rules. See .agent/project-context.md.

Agent CLI

pi used for child agents. See docs/agents/agent-cli.md.