Linear overlays on vendored skills

Most skills committed under .agents/skills/ are the Matt Pocock engineering skills, installed with npx skills and pinned by skills-lock.json. Each entry names the source (mattpocock/skills), the upstream skillPath, and a computedHash of the file as last installed.

An overlay is a Calab edit on top of that installed file: Linear instead of GitHub Issues, the intl-mocks team, the workspace States labels. The edited files are the rows in the table below. A typical edit is a short "Calab Linear" section, like the one in wayfinder/SKILL.md. Unlisted files are still the upstream text.

npx skills update reinstalls from the lock source and replaces those files. The overlay is gone. Put any rule that must survive that update in docs/agents/ (this page, issue-tracker.md, linear-work-items.md, triage-labels.md). After the update, re-apply only the table below before merging. Git history of those files is the other copy of the overlay text.

Are these skills in the calab APM registry?

The engineering skills in this repo are not backed up as APM primitives, and updates are meant to stay isolated.

skills-lock.json is the install source: mattpocock/skills on GitHub. npx skills update reads that, not the registry.
calab-ai/apm-registry vendors the same upstream skills under .agents/skills/ for agents working on the registry. That folder's README says they are not APM primitives. Shared packages for other repos live under primitives/skills/. The registry's own Calab edits are a separate copy. They do not flow into this repo, and this repo's edits do not flow back.
docs-site is the exception. It is APM primitive calab.skill.docs-site at primitives/skills/docs-site, version 1.2.2, the same version as .agents/skills/docs-site/apm-primitive.json. This repo's copy adds Entra ID and Pages hostname support that the registry file list does not include. Those local patches are listed in LOCAL_PATCHES.md and have to be re-applied when the primitive is re-vendored. They are not part of the Matt Pocock overlay table.

Overlay contract

Tracker-touching skills must:

Use the calab-ai Linear workspace on intl-mocks (MOC); fall back to gl04-technology (GL04)
Use the linear CLI or Linear MCP; never gh issue for Calab work items
Follow issue-tracker.md, linear-work-items.md, and triage-labels.md

Customized files

Path	Overlay
`ask-matt/SKILL.md`	`/handoff` → Linear issue; `/research` → Linear Document
`ask-matt/PHASE-BOUNDARIES.md`	Handoff portability is a Linear issue link
`handoff/SKILL.md`	Linear issue with `handoff` label, unassigned
`research/SKILL.md`	Linear Document; repo Markdown only when durable
`to-spec/SKILL.md`	Spec on issue or project document + companion issue for `ready-for-agent`
`to-tickets/SKILL.md`	Linear issues, blocking relations, States/Type labels
`triage/SKILL.md`	Six States roles including `needs-grill`; Linear intake
`triage/AGENT-BRIEF.md`	Briefs post to Linear issues
`wayfinder/SKILL.md`	Map is a Task issue with `wayfinder: map` marker; types in description; research → Linear Document
`implement/SKILL.md`	Branch + `Fixes`/`Refs` Linear ids
`setup-matt-pocock-skills/SKILL.md`	Linear is the fixed default; six States roles
`setup-matt-pocock-skills/triage-labels.md`	Includes `needs-grill`
`wizard/template.sh`	Browser-open fallback must fail so the visible warning runs

Unlisted skill files stay upstream. After update, re-apply only the rows above.