agentmods.dev

better-codebase AGENTS.md

Repository instructions for maintaining better-codebase, an installable collection of coding-agent skills focused on evidence-based, behavior-preserving reviews.

In plain words
What is it for?
Use them when adding or changing skills, plugin metadata, supporting references, prompts, or verification steps in the better-codebase repository.
Why use it?
They keep the skills focused, consistent across supported platforms, and resistant to unjustified refactoring or overengineering.

Instructions file for CodexOpenCode

1 23d ago A scan 289 tokens original MIT
View the source file NicolasYusim/better-codebase
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/nicolasyusim/better-codebase/agents-md
Clone the repo
git clone --depth 1 https://github.com/NicolasYusim/better-codebase

Made for: Codex, OpenCode.

Per session 289 This file is loaded in full into every session.
When invoked 289 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.00289 $0.00289
Opus 5 $0.00144 $0.00144
Sonnet 5 $0.00058 $0.00058
Haiku 4.5 $0.00029 $0.00029

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

Security

Grade A, and why

better-codebase 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 2d 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.

AGENTS.md · 37 lines

What it actually says

Better Codebase repository instructions

Treat this repository as an installable collection of agent skills.

Required principles

  • Preserve the evidence-first, behavior-preserving, anti-overengineering purpose.
  • Keep better-codebase orchestration-only; place each domain rule in one owner skill.
  • Use exact evidence, explicit uncertainty, smallest-safe-change guidance, and rejected alternatives.
  • Never add dogmatic architecture, style, coverage, version, or performance rules.

Skill structure

  • Keep skill folders under skills/<skill-name>/.
  • Keep YAML frontmatter to name and description only.
  • Keep each SKILL.md below 500 lines and use imperative instructions.
  • Update agents/openai.yaml when the skill name, purpose, or default prompt changes.
  • Link any supporting reference directly from the owning SKILL.md.

Cross-platform metadata

  • Keep .claude-plugin/plugin.json, .claude-plugin/marketplace.json, .codex-plugin/plugin.json, and .agents/plugins/marketplace.json aligned.
  • Keep version numbers synchronized across plugin manifests and CHANGELOG.md.
  • Preserve the standard skills/<name>/SKILL.md layout.

Verification

Run before completion:

python3 scripts/check_repo.py
python3 -m unittest discover -s tests -v

Do not edit generated or unrelated user files to make validation pass.

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. 2d ago First seen · 37 lines · 289 tokens per session scan A 273ebb553812

Subscribe to this mod's changes

better-codebase AGENTS.md is an instructions file published in the GitHub repository NicolasYusim/better-codebase (1 stars, last pushed 23d ago), licensed MIT. It adds 289 tokens to every session, about $0.0014 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.

Code reviewagent-skillsagentic-codingai-agentsai-codingautomated-refactoringclaude-code
Related

Other instructions, from other repositories

intuitive-flow CLAUDE.md

Instructions for MiaoDX/intuitive-flow, covering claude guide and claude-specific notes.

MiaoDX/intuitive-flow · 41 tokens

AmbyKit AGENTS.md

Instructions for ambystechcom/AmbyKit, covering agents.md — ambykit, what ambykit is, golden rules, project structure and build & test.

ambystechcom/AmbyKit · 1,216 tokens

repo-ready CLAUDE.md

Instructions for shidesheng0218/repo-ready, covering claude.md, stack, commands and rules.

shidesheng0218/repo-ready · 104 tokens

AmbyKit CLAUDE.md

Instructions for ambystechcom/AmbyKit, covering claude code — notes for the ambykit repo and claude-specific.

ambystechcom/AmbyKit · 257 tokens

ai-auto-work CLAUDE.md

Claude Code instructions for chaohong-ai/ai-auto-work, covering gamemaker - ai native 游戏创作平台, 项目简介, ai 工作目录约定 and 按需加载（不默认装载）.

chaohong-ai/ai-auto-work · 1,166 tokens

catalyst AGENTS.md

AGENTS.md instructions for coalesce-labs/catalyst, covering agents.md, what this repository is, agent philosophy, build & test and key principles.

coalesce-labs/catalyst · 6,878 tokens