agentmods.dev

ai-instruct CLAUDE.md

ai-instruct CLAUDE.md is an instructions file for coding agents from ziniman/ai-instruct. It costs 1,428 tokens per session, scanned A, original, Apache-2.0.

A set of instructions for the ai-instruct project, a collection of Markdown guides for developers using AI coding assistants. It also documents the Node.js command-line tool that installs those guides or turns them into Claude Code skills.

In plain words
What is it for?
Use it when changing the guides, CLI, skill installation, build process, or release workflow in ai-instruct.
Why use it?
It tells an agent how the repository is organized, where guide metadata lives, and how to preserve the project's dependency-free command-line setup.

Instructions file

not rated 28 3mo ago A scan 1,428 tokens original Apache-2.0
View the source file ziniman/ai-instruct
Install

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.

agentmods
npx agentmods add instructions/ziniman/ai-instruct/claude-md
Clone the repo
git clone --depth 1 https://github.com/ziniman/ai-instruct

Wrote 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.

agentmods badge for ai-instruct CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/ziniman/ai-instruct/claude-md.svg)](https://agentmods.dev/instructions/ziniman/ai-instruct/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/ziniman/ai-instruct/claude-md"><img src="https://agentmods.dev/badge/instructions/ziniman/ai-instruct/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 1,428 This file is loaded in full into every session.
When invoked 1,428 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5 $0.01428 $0.01428
Opus 5 $0.00714 $0.00714
Sonnet 5 $0.00286 $0.00286
Haiku 4.5 $0.00143 $0.00143

Measured 4d ago against content hash 3f17dbbe19ea, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

ai-instruct CLAUDE.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 4d 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.

CLAUDE.md · 108 lines

How it starts

The opening of the file, as written. The whole thing — 108 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

What this repo is

A collection of markdown guides for developers using AI coding assistants. The guides are consumed by other projects (pasted into chat, added to CLAUDE.md, .cursorrules, etc.) - this repo itself is not a web app or library.

The only runnable code is the CLI in bin/init.js, which users run via npx ai-instruct init in their own projects.

CLI

Run locally:

node bin/init.js                  # standard flow (detect tool, write to ai-docs/)
node bin/init.js --skills         # install as Claude Code skills in .claude/skills/
node bin/init.js --skills --user  # install in ~/.claude/skills/ (user scope)

Test the published package:

npx ai-instruct init

The CLI has no dependencies - it uses only Node.js built-ins (fs, os, path, readline) plus the global fetch (Node 18+). Do not add external packages.

bin/lib/guides.js is the single source of truth for the guide list (filenames, descriptions, skill names, skill descriptions). Both the CLI and the build script import from it.

Plugin and skills (Claude Code)

The repo also publishes itself as a Claude Code plugin. The plugin bundles all 5 guides as skills under skills/<skill-name>/SKILL.md.

  • skills/ is generated by scripts/build-skills.js from the canonical *-guide.md files plus the metadata in bin/lib/guides.js. Do not edit skills/<name>/SKILL.md by hand - edit the source guide and rebuild.
  • skills/ is committed to the repo (not gitignored) so users installing via /plugin install get the files without running a build.
  • .claude-plugin/plugin.json and .claude-plugin/marketplace.json describe the plugin and the marketplace (this repo is its own marketplace, so users can /plugin marketplace add ziniman/ai-instruct).
  • Versions in those two JSON files are synced from package.json by scripts/sync-versions.js, which runs automatically as part of npm version.

Read the full file on GitHub · 108 lines

Changes

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.

  1. 4d ago First seen · 108 lines · 1,428 tokens per session scan A 3f17dbbe19ea

Subscribe to this mod's changes

ai-instruct CLAUDE.md is an instructions file published in the GitHub repository ziniman/ai-instruct (28 stars, last pushed 3mo ago), licensed Apache-2.0. It adds 1,428 tokens to every session, about $0.0071 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-30.

Building agentsclaude-codeclaude-pluginsclaude-skills
Related

Other instructions, from other repositories

agent-plugins-skills copilot-instructions.md

Copilot instructions for richfrem/agent-plugins-skills, covering copilot instructions for agent-plugins-skills, 1. think before coding, 2. simplicity first, 3. surgical changes and 4. goal-driven execution.

richfrem/agent-plugins-skills · 6,511 tokens

claude-legal CLAUDE.md

Claude Code instructions for codearranger/claude-legal, covering claude.md, what this repo is, big-picture architecture, plugins at a glance and reference corpora at a glance.

codearranger/claude-legal · 13,184 tokens

agent-plugins-skills AGENTS.md

AGENTS.md instructions for richfrem/agent-plugins-skills, covering agents.md, 1. think before coding, 2. simplicity first, 3. surgical changes and 4. goal-driven execution.

richfrem/agent-plugins-skills · 6,472 tokens

claude-code-youtube-extract CLAUDE.md

Claude Code instructions for muckybuzzwoo/claude-code-youtube-extract, covering claude.md — yt-extract plugin, what this plugin is, components, architectural conventions and script cli (internal, skill-facing).

muckybuzzwoo/claude-code-youtube-extract · 3,924 tokens

the-unofficial-swift-programming-language-skill CLAUDE.md

Claude Code instructions for Shada01245/the-unofficial-swift-programming-language-skill, covering claude.md, repository purpose, build commands, generate the skill package and build options.

Shada01245/the-unofficial-swift-programming-language-skill · 1,017 tokens

claude-plugin-marketplace CLAUDE.md

Claude Code instructions for DennisLiuCk/claude-plugin-marketplace, covering repository overview, repository structure, plugin categories and inventory, development tools (10 plugins) and productivity tools (7 plugins).

DennisLiuCk/claude-plugin-marketplace · 4,982 tokens