From 94ec5d7da0c9f64cef7c5a57d7198626ff773842 Mon Sep 17 00:00:00 2001 From: Jesper Schulz-Wedde Date: Fri, 17 Apr 2026 13:50:04 +0200 Subject: [PATCH] Add skills/README.md as the meta-skills landing page Anyone (human or agent) browsing to /skills/ on GitHub previously saw a bare directory listing. This file names the three meta-skills, states the reading order, and describes who each is for. Replaces the placeholder .gitkeep. No contract changes -- this is a navigation aid. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- skills/.gitkeep | 0 skills/README.md | 17 +++++++++++++++++ 2 files changed, 17 insertions(+) delete mode 100644 skills/.gitkeep create mode 100644 skills/README.md diff --git a/skills/.gitkeep b/skills/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/skills/README.md b/skills/README.md new file mode 100644 index 0000000..8df7253 --- /dev/null +++ b/skills/README.md @@ -0,0 +1,17 @@ +# BCQuality meta-skills + +This folder contains the three global meta-skills — the contracts every consumer of BCQuality depends on. They are small, stable, and layer-agnostic. + +If you are an agent being pointed at BCQuality for the first time, read these files in order: + +| # | File | Role | Who reads it | +|---|---|---|---| +| 1 | [`read.md`](read.md) | **READ** — Schema + Use. How to read a knowledge file: frontmatter fields, section semantics, matching rules, layer precedence, conflict resolution. | Any agent or action skill that consumes knowledge files. | +| 2 | [`do.md`](do.md) | **DO** — Action Skill contract. The Source → Relevance → Worklist → Action template and the structured output every action skill produces. Includes super-skill composition. | Any agent invoking an action skill; every action-skill author. | +| 3 | [`write.md`](write.md) | **WRITE** — New Knowledge. Authoring rules for knowledge files. Defers to `read.md` for the schema. | Contributors (human or agent) who are adding or editing knowledge files. Not used during consumption. | + +After reading `read.md` and `do.md`, an agent has everything it needs to pick an action skill from `/microsoft/skills/` or `/community/skills/` and execute it. `write.md` is only needed when scaffolding new content. + +These contracts are stable. Changes require a PR approved by both maintainers. + +For the end-to-end flow — from orchestrator trigger through to findings integration — see [`../agent-consumption.md`](../agent-consumption.md). For the high-level project framing, see [`../README.md`](../README.md).