Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/zaks-io/skills/agents-mdgit clone --depth 1 https://github.com/zaks-io/skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/zaks-io/skills/agents-md)<a href="https://agentmods.dev/instructions/zaks-io/skills/agents-md"><img src="https://agentmods.dev/badge/instructions/zaks-io/skills/agents-md.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00911 | $0.00911 |
| Opus 5 | $0.00456 | $0.00456 |
| Sonnet 5 | $0.00182 | $0.00182 |
| Haiku 4.5 | $0.00091 | $0.00091 |
Grade A, and why
skills AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 81 lines — stays where its author put it; the contents beside it link to each section on GitHub.
zaks-io-skills Agent Guide
Purpose
This repo publishes shared workflow skills for engineering agents. The skills help agents set up repo-local workflow config, move issue-tracked work through implementation, review code and PRs, and create or update PRs consistently.
AGENTS.md is the source of truth for agent guidance. Keep CLAUDE.md as a
one-line @AGENTS.md import so Claude Code and other agents read the same
content.
Map
skills/<skill>/SKILL.md: portable skill instructions. Each skill should have one job and one top-level heading.skills/<skill>/agents/openai.yaml: Codex adapter and trigger fixture for the matching skill..claude-plugin/plugin.json: Claude Code plugin manifest..agents/: repo-internal runbooks that are not published by skill discovery.agents/<agent>.md: Claude Code sub-agent definitions for the few workflow roles that benefit from isolated context.skills/ziw-setup/references/: templates and contracts used to create downstreamdocs/agents/workflow/config.md.skills/ziw-code-review/references/: review support material.docs/agent-workflow.md: technical workflow contract, state model, and role split.docs/skill-distribution.md: source-backed policy for project skills, plugins, global installs, lockfiles, and downstream refresh PRs.docs/skill-portfolio.md: publishable skill surface, trim criteria, and keep/remove rationale.docs/agents/workflow/config.md: repo-local workflow lookup table. Read it before runningziw-*workflow skills in this repo.scripts/check-skills.mjs: structural validation and repo invariants.scripts/update-downstream-skills.mjs: discovers downstreamskills-lock.jsonconsumers, runs project-scope skill updates, and reports repos needing PRs.scripts/workflow-contract.mjs: pure workflow decision helpers covered bynode --test.README.md: user-facing overview, quick start, and install commands.
Repo Rules
- Add shared skills under
skills/ziw-*. - Keep repo-internal procedures under
.agents/; do not make them publishable skills unless they are meant to ship to downstream repos. - Keep runtime-specific metadata minimal. Tool providers, commands, environments,
issue tracker states, and deploy rules belong in each downstream repo's
docs/agents/workflow/config.md. - Preserve support for both Claude and Codex skill types. When adding or
changing a skill, keep the portable
SKILL.mdcontract, Claude-compatible frontmatter, and Codexagents/openai.yamlmetadata in sync. - All published skills are model-invocable in Claude frontmatter and
agents/openai.yaml. Invocation selects a workflow; it does not expand the authority granted by the user's request, repo config, production approval, or merge rules. - Claude Code sub-agents live only in root
agents/, load skill files through${CLAUDE_PLUGIN_ROOT}, and usemodel: inherit. Keep them limited to context-heavy delegation roles, not every workflow skill. ziw-code-reviewis the implicit review gate and runs from clean context, both as the pre-PR gate and in independent/checkpoint mode.- Do not add per-skill scripts unless
scripts/check-skills.mjsis updated to allow that skill. - Update
docs/skill-portfolio.mdwhenever adding, removing, demoting, or merging a publishable skill.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 5d ago First seen · 81 lines · 911 tokens per session scan A 44fedd1d970f
skills AGENTS.md is an instructions file published in the GitHub repository zaks-io/skills (3 stars, last pushed 5d ago), licensed MIT. It adds 911 tokens to every session, about $0.0046 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other instructions, from other repositories
mcpx AGENTS.md
AGENTS.md instructions for lydakis/mcpx, covering agents.md, scope, working style, quality gates and architecture boundaries.
agentdeck CLAUDE.md
Claude Code instructions for agentdecksdk/agentdeck, covering agentdeck, 1. product philosophy & north star, 2. architecture & layout, 3. engineering & coding standards and 4. verification gate & conventions.
ai-maintainer-copilot-skill AGENTS.md
Instructions for yuxiaoji30-lang/ai-maintainer-copilot-skill, covering agents.md, where the skill lives, what this skill is for, hard rules for any agent using this repo and validating changes.
agentdeck AGENTS.md
AGENTS.md instructions for agentdecksdk/agentdeck: See CLAUDE.md - single source of agent instructions for this repo.
work-skill AGENTS.md
Instructions for xcaeser/work-skill: Read skills/QUALITY.md before changing this project or any nested Work skill. Treat it as the project's quality bar.
stephen-claude CLAUDE.md
Instructions for StephenQiu30/stephen-claude, covering claude.md, 核心原则, sdd / tdd / rag 门禁, 唯一交付流程 and 执行流程.