showxu · Oct 26, 2026 · Oct 26, 2026 · Oct 26, 2026 · Oct 26, 2026 · Oct 26, 2026
diff --git a/.agent/agents.json b/.agent/agents.json
@@ -0,0 +1,7 @@
+{
+  "instructions": {
+    "agents": ["claude-code", "codex"],
+    "sections": ["guide"]
+  },
+  "sources": {}
+}
diff --git a/.agent/agents.resolved b/.agent/agents.resolved
@@ -0,0 +1,24 @@
+{
+  "instructions": {
+    "chatgpt": {},
+    "sections": [
+      {
+        "hash": "sha256:11beaaf8ece7a92390dfdf0e78c7d8adbd12667843c09f08c2f95b219e1f8fb8",
+        "name": "guide",
+        "path": ".agent/instructions/guide.md",
+        "source": "."
+      }
+    ],
+    "targets": {
+      "AGENTS.md": {
+        "agents": ["claude-code", "codex"],
+        "blockHash": "sha256:41fa0e79aa39d2bf0b3a140238308e50791c76e73542560ebd57a9a8d9193b88",
+        "created": false,
+        "headingOffset": 0
+      }
+    }
+  },
+  "skills": {},
+  "sources": {},
+  "version": 1
+}
diff --git a/.agent/instructions/guide.md b/.agent/instructions/guide.md
@@ -0,0 +1,35 @@
+---
+description: Route changes to skill-cli organization data, generated assets, design tokens and their checks.
+---
+# Agent Guide
+
+Read `README.md` first.
+
+- This repository owns organization data, generated assets and documents.
+  Reusable workflows and checkers live in
+  [agents-tools/github-workflows](https://github.com/agents-tools/github-workflows);
+  local workflows are thin callers.
+- `profile/README.md` and `.github/assets/social-preview/social-preview.png`
+  are generated locally with the `github-readme-design` toolchain. Follow the
+  [renderer commands](https://github.com/showxu/skills/blob/master/skills/github-readme-design/references/renderers.md)
+  and `README.md`; commit inputs and outputs together.
+- Keep catalog membership equal to the organization's public, non-archived,
+  non-fork repositories except `.github`. Every catalog `about` must equal the
+  live repository description, including `organization.about` for `.github`.
+  The shared organization checker verifies membership and About text.
+- Settings, rulesets and required checks are declared in
+  [agents-tools/.github MAINTENANCE](https://github.com/agents-tools/.github/blob/master/MAINTENANCE.md).
+  The organization caller pins that declaration separately from its workflow
+  implementation and reads this repository's catalog at the commit under test.
+  Required checks here are `policy / policy` and `check`.
+- Repository summaries state what the repository does for a visitor, in one
+  sentence, from that repository's current behavior.
+- `DESIGN.md` owns the organization's visual tokens and icon entry. Read it
+  before visual or asset work. Lint it with zero errors and zero warnings and
+  regenerate every affected output after token or icon artwork changes.
+  Record consumed icon copies and their SHA-256 digests in
+  `.github/design/icons/*/provenance.json`; verify updated copies locally.
+- Before handoff, run `actionlint`, toolchain DESIGN lint, profile check,
+  social-preview check where an output exists, and
+  `git diff --check origin/master`. Review generated output changes locally.
+  Report live drift and unknowns; shared checks never change settings.
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -18,7 +18,7 @@ jobs:
   organization:
     permissions:
       contents: read
-    uses: agents-tools/github-workflows/.github/workflows/organization.yml@2ce48fb8834304acf010fa1b47a05db6148ab6c4
+    uses: agents-tools/github-workflows/.github/workflows/organization.yml@bb0a8c8c39827a364b9d3cbf4069754e7d975586
     with:
       organization: skill-cli
       declaration-repository: agents-tools/.github

diff --git a/.github/workflows/source-policy.yml b/.github/workflows/source-policy.yml
@@ -18,7 +18,7 @@ jobs:
   policy:
     permissions:
       contents: read
-    uses: agents-tools/github-workflows/.github/workflows/policy.yml@2ce48fb8834304acf010fa1b47a05db6148ab6c4
+    uses: agents-tools/github-workflows/.github/workflows/policy.yml@bb0a8c8c39827a364b9d3cbf4069754e7d975586
     with:
       allow-terms: |
         ChatGPT

diff --git a/.gitignore b/.gitignore
@@ -1,3 +1,6 @@
 .build/
-.agent/
 .DS_Store
+/.agent/*
+!/.agent/instructions/
+!/.agent/agents.json
+!/.agent/agents.resolved
diff --git a/AGENTS.md b/AGENTS.md
@@ -1,3 +1,5 @@
+<!-- Generated by agents from instruction files. Edit those files and run `agents update`. -->
+
 # Agent Guide
 
 Read `README.md` first.