From d6282d4c6c4d237e8e20abd740b20e9c5945f3db Mon Sep 17 00:00:00 2001 From: Matt McKay Date: Tue, 25 Aug 2026 12:25:39 +1000 Subject: [PATCH 1/2] =?UTF-8?q?Docs:=20last=20single-plugin=20tidy=20?= =?UTF-8?q?=E2=80=94=20intro,=20section=20heading,=20site=20description?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Three spots #53's sweep missed: README still framed the repo as multiple plugins (intro sentence, auto-install line, contributing line), using-skills still headed its skill table "The plugins", and myst.yml's site description still advertised style checks — which are planned (#3), not shipped. Repo-level files only; nothing under qe/ changes, so no version bump. Co-Authored-By: Claude Fable 5 --- README.md | 6 +++--- docs/using-skills.md | 2 +- myst.yml | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index a5121a5..ac994a5 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ A [Claude Code plugin marketplace](https://code.claude.com/docs/en/plugin-marketplaces) housing QuantEcon's shared agent skills and their supporting scripts. -Each plugin bundles one area of work — a skill (the instructions Claude follows) plus the deterministic scripts it drives — so the same versioned toolkit works locally for authors and RAs, and headlessly in CI. +One plugin, `qe`, bundles the skills (the instructions Claude follows) with the deterministic scripts they drive, so the same versioned toolkit works locally for authors and RAs, and headlessly in CI. 📖 **[quantecon.github.io/skills](https://quantecon.github.io/skills)** — the documentation, rendered and navigable. It is built from the files in this repository, so reading either one gets you the same content. @@ -30,7 +30,7 @@ Start with [docs/using-skills.md](docs/using-skills.md) to use the skills, and [ ### Automatic (lecture repos) -Lecture repositories opt in by checking the following into their `.claude/settings.json`. Anyone who opens the repo and trusts it gets the marketplace and plugins installed automatically — no commands to run: +Lecture repositories opt in by checking the following into their `.claude/settings.json`. Anyone who opens the repo and trusts it gets the marketplace and plugin installed automatically — no commands to run: ```json { @@ -70,6 +70,6 @@ The official action accepts the marketplace and plugin directly: ## Contributing -Open a PR adding or modifying a plugin directory and registering it in `.claude-plugin/marketplace.json`. The whole workflow — repo layout, conventions, local testing, validation (`python scripts/validate.py`), and the version-bump-plus-changelog rule that CI enforces on every plugin change — is in [docs/developing-skills.md](docs/developing-skills.md), and the repo-wide ground rules are in [AGENTS.md](AGENTS.md). +Open a PR modifying the `qe/` plugin directory (its `marketplace.json` entry included when the version moves). The whole workflow — repo layout, conventions, local testing, validation (`python scripts/validate.py`), and the version-bump-plus-changelog rule that CI enforces on every plugin change — is in [docs/developing-skills.md](docs/developing-skills.md), and the repo-wide ground rules are in [AGENTS.md](AGENTS.md). Broader context for this repository: [QuantEcon/meta#304](https://github.com/QuantEcon/meta/issues/304) (toolkit proposal) and [QuantEcon/meta#335](https://github.com/QuantEcon/meta/issues/335) (benchmarking programme). diff --git a/docs/using-skills.md b/docs/using-skills.md index 234edf1..52859fc 100644 --- a/docs/using-skills.md +++ b/docs/using-skills.md @@ -37,7 +37,7 @@ Two ways, equivalent: - **Evidence, not vibes.** Reports cite rule IDs, `file:line` locations, and measured numbers. The benchmark skill goes further: its scores are computed by a deterministic engine from recorded evidence — the session shows the full derivation. - **The same skill works pre-PR and in review.** Run it on your working copy before opening a PR (catch issues early), or point it at an open PR (consistent review). -## The plugins +## The skills Everything that registers in your slash menu — one plugin, five skills. Since `qe` 0.6.0 every entry is a skill that actually runs — an unbuilt skill lives only as the plan in its family's tracking issue (the style-check family, for example, is [skills#3](https://github.com/QuantEcon/skills/issues/3)). [CATALOG.md](../CATALOG.md) is the stricter list: merged, operational, *and* stating how far each has been validated. diff --git a/myst.yml b/myst.yml index 92e5f65..b866633 100644 --- a/myst.yml +++ b/myst.yml @@ -12,8 +12,8 @@ project: title: QuantEcon Skills description: >- QuantEcon's shared Claude Code skills and the deterministic scripts they - drive — style checks for authors, acceleration evaluation, and bulk - repository audits. + drive — PR review support for authors, acceleration triage and review, + bulk repository audits, and cross-session work-plan tooling. github: https://github.com/QuantEcon/skills toc: - file: README.md From 1ab4b19d30da4ef6e74b2c5b255c3e2f045b21b4 Mon Sep 17 00:00:00 2001 From: Matt McKay Date: Tue, 25 Aug 2026 12:42:06 +1000 Subject: [PATCH 2/2] Docs: Contributing covers docs PRs too, and names the catalogue path MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Copilot's review of #54 caught the rewritten Contributing line reading as if only plugin-directory changes count — docs-only PRs are equally valid — and "its marketplace.json entry" not saying the catalogue lives at .claude-plugin/marketplace.json. Co-Authored-By: Claude Fable 5 --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index ac994a5..d8539d4 100644 --- a/README.md +++ b/README.md @@ -70,6 +70,6 @@ The official action accepts the marketplace and plugin directly: ## Contributing -Open a PR modifying the `qe/` plugin directory (its `marketplace.json` entry included when the version moves). The whole workflow — repo layout, conventions, local testing, validation (`python scripts/validate.py`), and the version-bump-plus-changelog rule that CI enforces on every plugin change — is in [docs/developing-skills.md](docs/developing-skills.md), and the repo-wide ground rules are in [AGENTS.md](AGENTS.md). +Open a PR — repo-level docs and plugin changes alike. A change under `qe/` bumps the plugin version in both `qe/.claude-plugin/plugin.json` and its entry in `.claude-plugin/marketplace.json`; the whole workflow — repo layout, conventions, local testing, validation (`python scripts/validate.py`), and the version-bump-plus-changelog rule that CI enforces — is in [docs/developing-skills.md](docs/developing-skills.md), and the repo-wide ground rules are in [AGENTS.md](AGENTS.md). Broader context for this repository: [QuantEcon/meta#304](https://github.com/QuantEcon/meta/issues/304) (toolkit proposal) and [QuantEcon/meta#335](https://github.com/QuantEcon/meta/issues/335) (benchmarking programme).