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/blazity/nextjs-migration-plugin/agents-mdgit clone --depth 1 https://github.com/Blazity/nextjs-migration-pluginWhat 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.01805 | $0.01805 |
| Opus 5 | $0.00903 | $0.00903 |
| Sonnet 5 | $0.00361 | $0.00361 |
| Haiku 4.5 | $0.00180 | $0.00180 |
Grade A, and why
nextjs-migration-plugin 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 yesterday.
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 — 143 lines — stays where its author put it; the contents beside it link to each section on GitHub.
nextjs-migration-plugin
This file is the canonical prose-rules surface for AI agents working in this repository. Codex, Cursor, Windsurf, and VS Code Copilot read it natively; Claude Code reads it through the @AGENTS.md shim in CLAUDE.md.
Vision
nextjs-migration-plugin is a Claude Code plugin for migrating public websites into production-ready Next.js App Router projects. It turns a source URL, optional source repository, and migration goal into a phased, resumable workflow with persistent .migration/ state, shared component discovery, build generation, and verification gates.
Direction
The current product direction is a pre-release v1 focused on phases 1-5: discover, analyze, plan, extract, and build. Polish phases for visual parity, animation, performance, add-pages, library inspection, runs, and ship workflows are part of the approved design but are not all present in the current repository.
Repository Layout
| Path | What it is |
|---|---|
plugin.json |
Claude Code plugin manifest, hard dependencies, hooks, command/skill/agent roots. |
commands/ |
Thin slash-command wrappers for /migrate:* commands. |
skills/ |
Project runtime skills, one directory per migration workflow. |
agents/ |
Agent prompt templates used by migration phases. |
lib/ |
TypeScript orchestration, loaders, schemas integration, state helpers, and phase runners. |
schemas/ |
Zod schemas for adapters and migration state artifacts. |
scripts/ |
Vendored extraction, crawl, validation, build, and visual tooling. Preserve vendor policy. |
adapters/ |
Framework/CMS adapter JSON plus the generated schema template. |
knowledge/ |
Shipped runtime knowledge loaded by plugin hooks and phase skills. |
docs/ |
Canonical product docs: specs and ADRs. |
.ai/ |
Shared AI harness: memory, plans, research, and vendored superpowers skills. |
test/ and scripts/tests/ |
Vitest coverage for core library behavior and script helpers. |
This is a single-package TypeScript repository using pnpm, Node.js, ESM, and Vitest. It is not a monorepo.
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.
- yesterday First seen · 143 lines · 1,805 tokens per session scan A c2e37332099b
nextjs-migration-plugin AGENTS.md is an instructions file published in the GitHub repository Blazity/nextjs-migration-plugin (2 stars, last pushed 1mo ago), licensed MIT. It adds 1,805 tokens to every session, about $0.0090 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
roshantaneja.github.io CLAUDE.md
Claude Code instructions for roshantaneja/roshantaneja.github.io, covering claude.md, commands, post-change maintenance protocol, environment variables and architecture.
core CLAUDE.md
Claude Code instructions for module-federation/core, covering claude task parallelization & development guidelines, core principles, maximum parallelization strategy, universal parallel task patterns and for any codebase task.
Codex-Skills AGENTS.md
Instructions for TheGoat395/Codex-Skills, covering repository operating notes, required checks, evidence rules and change hygiene.
souls-directory CLAUDE.md
Instructions for thedaviddias/souls-directory, covering claude.md — project context for ai assistants, project overview, tech stack, critical rules and database is convex.
nextarter-tailwind AGENTS.md
AGENTS.md instructions for agustinusnathaniel/nextarter-tailwind, covering next.js: always read docs before coding, ai agent guidance: nextarter-tailwind, 1. mental model for agents, implementation delegation and tooling strategy.
agentgram CLAUDE.md
Instructions for agentgram/agentgram, covering claude.md — agentgram development guide, project overview, tech stack, monorepo structure and core architecture patterns.