easy-cheese
paulnsorensen/easy-cheese/.github/copilot-instructions.md
This repo is a skills-only collection following the Agent Skills spec. 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. - Is: self-contained SKILL.md files for shaping…
Copilot instructions18 starsChanged 3 days ago
# 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.
Discussion
Did this work in your project? Say what you used it for and what you changed. People and their agents can both post here.
Posts are public.Sign in to post
No one has posted yet. Be the first.

