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/productdevbook/shadcn-htmx/agents-mdgit clone --depth 1 https://github.com/productdevbook/shadcn-htmxWrote 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/productdevbook/shadcn-htmx/agents-md)<a href="https://agentmods.dev/instructions/productdevbook/shadcn-htmx/agents-md"><img src="https://agentmods.dev/badge/instructions/productdevbook/shadcn-htmx/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.02254 | $0.02254 |
| Opus 5 | $0.01127 | $0.01127 |
| Sonnet 5 | $0.00451 | $0.00451 |
| Haiku 4.5 | $0.00225 | $0.00225 |
Grade A, and why
shadcn-htmx 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 3d 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 — 144 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Agent Guide
This repository builds a shadcn-style component library for htmx v4 + Tailwind CSS v4, anchored to web standards. The goal is components that work because the platform supports them — no hacks, no userland reinvention of features the browser already ships.
To make that possible, this repo vendors the source code and documentation of the libraries and specs we depend on under repos/. You should read those vendored sources before you write or modify code. They are not training data; they are the current, authoritative ground truth for this project.
Hard rules
repos/is read-only reference material. Never import from it, bundle it, or copy code out of it intosrc/. If you need something from a vendored repo in our shipped code, rewrite it in our style — don't transplant.- Do not commit changes inside
repos/. It is managed byscripts/sync-repos.sh. Local edits there will be wiped on the next sync. - Prefer reading
repos/over recalling from training data. Your training cutoff predates current htmx v4 and Tailwind v4 details. When the vendored source disagrees with what you remember, the vendored source wins. - No hacks. If a feature requires polyfills, runtime feature-detection branches, or workarounds for "browsers don't do this yet," stop and ask. This project ships only what the platform supports natively today. Progressive enhancement is fine; emulation is not.
- Cite what you read. When you make a non-obvious decision, mention which file under
repos/justified it (e.g.,repos/htmx/src/htmx.js:1234). This lets reviewers verify against the source.
What's vendored, and when to read each
repos/htmx/ — htmx v4 source (branch: four-dev)
The htmx v4 development branch. This is the version we target. v3 syntax and behaviors are not authoritative here.
- Read for: attribute names and semantics (
hx-*), event names, the request/swap lifecycle, extension API, behavioral differences from v3. - Best entry points:
repos/htmx/src/— core implementation.htmx.jsis the main file.repos/htmx/www/src/content/— official docs (Astro content). Markdown reference for every attribute and concept.repos/htmx/www/reference.md— single-file API reference.repos/htmx/CHANGELOG.md— what changed from v3 to v4.repos/htmx/test/— behavioral specifications by example.
- Do not assume v3 behavior. If you're not sure whether something changed in v4, grep the source.
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.
- 3d ago First seen · 144 lines · 2,254 tokens per session scan A 8c72202b239e
shadcn-htmx AGENTS.md is an instructions file published in the GitHub repository productdevbook/shadcn-htmx (51 stars, last pushed 3mo ago), licensed MIT. It adds 2,254 tokens to every session, about $0.0113 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.
Other instructions, from other repositories
liquefy-ui CLAUDE.md
Instructions for liquefy-ui/liquefy-ui, covering repository rules, commits, everything else, language and css and visual work.
starwind-ui AGENTS.md
Instructions for starwind-ui/starwind-ui, covering agents.md, project shape, useful commands and contribution conventions.
primitives AGENTS.md
Instructions for radix-ng/primitives, covering agent guide and storybook styling.
animal-island-ui AGENTS.md
AGENTS.md instructions for guokaigdg/animal-island-ui, covering agents.md — working in this repository, read first, by task, verification, content that must be kept in sync and ground rules.
animal-island-ui CLAUDE.md
Claude Code instructions for guokaigdg/animal-island-ui, a project described as: Animal Crossing-style React UI component library, inspired by Nintendo's game visuals Vue version available. Animal 风格的 React 组件库 灵感来源于任天堂《集合啦！动物森友会》 Vue 版同步发布.
kernel-ui AGENTS.md
Instructions for kemiljk/kernel-ui, covering working in this repo, release checklist for pull requests, the one rule that matters most: build every component twice, repo layout and conventions to match, not reinvent.