Arnaud Zheng's Agent Skills (SKILL.md) for Diataxis documentation, tests, skill linting and
reviews. They install with a version and uninstall cleanly in
Claude Code, Codex,
Cursor, GitHub Copilot CLI and any other
agent that reads SKILL.md, instead of being copy-pasted into each agent's folder. Every skill here
is linted, tested and versioned.
The Agent Skills ship in the arnaud-zg plugin. Pick one by what you want to do; what each needs
and how to call it are in the plugin's skills table.
| When you want to… | Use |
|---|---|
| Write an Agent Skill and lint it | hexagonal-skill-builder |
| Keep a codebase's core free of its database and tools: hexagonal, clean architecture | hexagonal-architecture |
| Write and check Diataxis docs, with examples a test runs | doc-compass |
| Plan, write or audit tests: mostly integration, a few unit and end to end | testing-trophy |
| Lower the Big O of slow code, O(n²) to O(n), proven by your tests | big-o-optimizer |
| Cut a process, product or UI down to its simplest version | radical-simplify |
| Turn any work into a one-minute read: TLDR, key numbers, one diagram per point | glance-first |
| Get a sceptical review of a doc, plan or PR, with comments ready to paste | glance-audit |
| After a session, find what made the skills slow or costly and fix them | skill-retro |
| Check if the next job fits in your Claude usage window: GO or PARK | usage-runway |
One repository, one manifest per agent, the same skills behind each:
| Agent | Install | Reads |
|---|---|---|
| Claude Code | /plugin install arnaud-zg --marketplace arnaud-zg/skills |
.claude-plugin/ |
| Codex | codex plugin marketplace add arnaud-zg/skills, then install arnaud-zg from /plugins |
.agents/plugins/, .codex-plugin/ |
| GitHub Copilot CLI | copilot plugin marketplace add arnaud-zg/skills, then copilot plugin install arnaud-zg@arnaud-zg-skills |
.claude-plugin/ |
| Cursor | add arnaud-zg/skills as a plugin marketplace in Cursor's settings |
.cursor-plugin/ |
| Gemini CLI, OpenCode, others | npx skills add arnaud-zg/skills --skill <name> |
SKILL.md folders |
Each plugin's README shows how to pin the version you reviewed, and how to give it to a whole team.
A plugin's hooks run shell commands on your machine and its MCP servers talk to remote endpoints,
with no sandbox. Read hooks/, .mcp.json and dependencies before installing anything, here or
anywhere else.
Start at the documentation home: a map of every page. The docs follow
Diataxis: one page per reader need. The pages below cover writing and
shipping plugins in this repository; each plugin's own docs/ covers using it.
- 🚀 Tutorial: build and install your first plugin, end to end.
- 🛠️ How-to guides: add a skill, agent, hook, MCP server or dependency; document it; test locally; release; rename.
- 📖 Reference: every manifest field, component discovery rule, and CLI command.
- 💡 Explanation: what skills, plugins and marketplaces are, and why the layers are split that way.
Prettier, ESLint, TypeScript, remark, commitlint and Lefthook all come from
@arnaud-zg/configs. See
CONTRIBUTING.md to make a change.
MIT