copilot-instructions.md · git:20261017.16eb737 · 2026-10-17 · sha256 bd461c5e586b12ec

copilot-instructions.md git:20261017.16eb737A

Immutable. This exact content never changes and is served at /api/v1/blob/bd461c5e586b12ec.

# Copilot review instructions — easy-cheese

This repo is a skills-only collection following the
[Agent Skills spec](https://agentskills.io/specification). Every change either
adds, edits, or supports a skill under `skills/<name>/`. There is no
production runtime: review focuses on **skill quality**, not application
behavior.

When reviewing a PR, treat it the way the `/skill-creator` skill would: care
about whether the skill will *trigger* when it should, whether it teaches the
model *why* not just *what*, and whether bundled resources earn their keep.

## What this repo is and isn't

- **Is**: self-contained `SKILL.md` files for shaping ideas, implementing
  them, and reviewing the result. Workflow skills (`mold`, `culture`, `cook`,
  `press`, `age`, `cure`, `melt`, `cheese`, `briesearch`) call source-code
  backends directly through the shared routing contract.
- **Isn't**: an agent framework, an orchestrator, or a mandatory-MCP runtime. Native LSP/AST/anchored-edit backends may satisfy `skills/cheese/references/code-intelligence-routing.md` without a specific MCP.
Keep this scope in mind — flag scope creep (intent classification baked into
a workflow skill, multi-CLI fan-out inside a tool skill, implicit cross-skill
invocation) at review time. Cross-skill handoffs belong in the README's
"Suggested flow" or in the skill's own routing section, not as silent
auto-dispatch.

## Skill review priorities (in order)

Apply the path-scoped instructions in `.github/instructions/` for the
specifics. The summary order:

1. **Triggering** — does the description tell Claude when to use this skill,
   in language users actually type?
2. **Progressive disclosure** — is `SKILL.md` lean? Does deeper material live
   in `references/`, `scripts/`, `assets/` instead of inline?
3. **Why over what** — does the skill explain reasoning, or just bark MUSTs?
4. **Bundled resources earn their keep** — every `references/<file>.md` and
   `scripts/<file>` should have a clear pointer from `SKILL.md` telling the
   model when to load or run it.
5. **Anti-overfit** — instructions generalize across realistic prompts, not
   just the examples baked into the skill itself.

## What not to flag

- Cheese / Dune / Mad Max flavor in user-facing docs. It's intentional repo
  voice. Commit messages and YAML frontmatter stay neutral.
- Backward-compat shims, deprecation paths, migration plans — this repo is
  early-stage and treats every release as the new baseline.
- Style nits already covered by the validators (`markdownlint`, `yamllint`,
  `.github/scripts/validate_skills.py`). CI catches those; reviewers should
  focus on skill-design issues that linters miss.

## How to write review comments

- Lead with user impact: "this description would miss users who say X".
- Quote the smallest section of the skill that needs changing.
- Suggest the rewrite, don't just diagnose.
- If a finding is speculative ("might confuse some users"), say so — don't
  inflate it into a blocker.