Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

fix(skills): keep project review skills internal to the repository

tt-a1i7ef7c0ccd26b
diff --git a/.agents/skills/README.md b/.agents/README.md
similarity index 70%
rename from .agents/skills/README.md
rename to .agents/README.md
index 6e99e81b..13d01968 100644
--- a/.agents/skills/README.md
+++ b/.agents/README.md
@@ -1,6 +1,6 @@
# Project review Skills
-These Skills support the scoped [PR improvement check](../../CONTRIBUTING.md#pr-improvement-check).
+These Skills support the scoped [PR improvement check](../CONTRIBUTING.md#pr-improvement-check).
They are repository files, usable without a global installation or personal filesystem paths.
| Skill | Upstream | Pinned commit | Included files |
@@ -8,8 +8,11 @@ They are repository files, usable without a global installation or personal file
| simplify-codebase | [tt-a1i/simplify-codebase](https://github.com/tt-a1i/simplify-codebase) | `f8f7084801272f46e35531dcca29bff20f1935f6` | SKILL.md, references/, agents/, LICENSE |
| test-value | [tt-a1i/test-value](https://github.com/tt-a1i/test-value) | `e111931defac959ad11ddc67b8eb2f3743d08129` | SKILL.md, references/, agents/, LICENSE |
-Included files are byte-for-byte copies at the recorded commits, with their MIT
-licenses and attribution retained. simplify-codebase uses the text-only release
+All included files match the recorded upstream commits except the two SKILL.md
+frontmatters, which add `metadata.internal: true` using Archify’s existing
+maintainer-Skill convention. This keeps them available as project guidance while
+excluding them from the public Skills CLI installation list. Instruction bodies,
+MIT licenses, and attribution remain unchanged. simplify-codebase uses the text-only release
before the optional Cleanup Map renderer was introduced; PR preparation needs
its consumer/contract proof workflow. Its included references are complete for
this revision. Runtime diagram sources and the distributed Archify Skill remain
diff --git a/.agents/skills/simplify-codebase/SKILL.md b/.agents/skills/simplify-codebase/SKILL.md
index 5e3139ab..a016bab7 100644
--- a/.agents/skills/simplify-codebase/SKILL.md
+++ b/.agents/skills/simplify-codebase/SKILL.md
@@ -1,6 +1,8 @@
---
name: simplify-codebase
description: Simplification audit or authorized codebase simplification whose stated objective is to remove accidental complexity. Use for evidence-backed deletion or consolidation of dead code, duplicate state, redundant APIs or layers, ownerless abstractions, obsolete compatibility or design records, and over-engineering in any language; also use for 代码简化 or 熵回收. Do not use for general code review, onboarding, style-only refactoring, or performance tuning.
+metadata:
+ internal: true
---
# Simplify Codebase
diff --git a/.agents/skills/test-value/SKILL.md b/.agents/skills/test-value/SKILL.md
index 309b172b..9d947cc5 100644
--- a/.agents/skills/test-value/SKILL.md
+++ b/.agents/skills/test-value/SKILL.md
@@ -1,6 +1,8 @@
---
name: test-value
description: Improve test value and feedback cost when auditing slow, flaky, redundant or brittle tests; choosing tests during implementation; or reviewing test changes before a commit or PR. Keep ordinary implementation and pre-commit use scoped to the affected behavior, not a repository-wide audit.
+metadata:
+ internal: true
---
# Test Value
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 1f7900af..6d7e8256 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -53,7 +53,7 @@ under [Choose evidence by impact](#choose-evidence-by-impact); this check adds n
separate audit report or CI gate. Repository instructions govern scope and
publication authority. Treat the two vendored Skills as read-only guidance in
ordinary PRs; update their pinned sources through a dedicated reviewed change.
-See [Skill sources](.agents/skills/README.md) for provenance and update procedure.
+See [Skill sources](.agents/README.md) for provenance and update procedure.
## Choose evidence by impact