ai-agents-skills: Instructions file for Claude Code

AGENTS.md

ai-agents-skills AGENTS.md is an instructions file for Claude Code, Codex, OpenCode from Xakki/ai-agents-skills. It costs 733 tokens per session, scanned A, original, MIT.

Repository instructions for sharing the same AI-agent skills across Claude Code, Codex, Cursor, Hermes Agent, and Prime Agent.

In plain words
What is it for?
Maintaining shared skills, plugin manifests, lifecycle hooks, registration adapters, and package-specific conventions across several coding assistants.
Why use it?
They prevent each tool from getting a separate, inconsistent copy of the same skill and keep tool-specific integration code in its proper place.

Instructions file for Claude CodeCodexOpenCode

Written for Claude Code and Codex and OpenCode: Claude Code plugin machinery, but also the file is AGENTS.md. Also seen: mentions Claude Code; mentions AGENTS.md; mentions Codex.

This is Xakki/ai-agents-skills's own configuration. It tells Claude Code, Codex and OpenCode how to work on ai-agents-skills itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything ai-agents-skills configures →

Reuse

Borrowing it

Nothing to install: this file belongs to Xakki/ai-agents-skills. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/Xakki/ai-agents-skills/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/Xakki/ai-agents-skills

Made for: Claude Code, Codex, OpenCode.

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-agents-skills AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/xakki/ai-agents-skills/agents-md.svg)](https://agentmods.dev/instructions/xakki/ai-agents-skills/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/xakki/ai-agents-skills/agents-md"><img src="https://agentmods.dev/badge/instructions/xakki/ai-agents-skills/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 733 This file is loaded in full into every session.
When invoked 733 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00733 $0.00733
Opus 5 $0.00367 $0.00367
Sonnet 5 $0.00147 $0.00147
Haiku 4.5 $0.00073 $0.00073

Measured 8d ago against content hash a8260ec84aac, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

ai-agents-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 8d 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 · 52 lines

How it starts

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

AGENTS.md

This repository ships five integrations from the same source tree: Claude Code, Codex, Cursor Agent CLI/IDE, Hermes Agent, and Prime Agent:

  • .claude-plugin/plugin.json + .claude-plugin/marketplace.json — Claude Code manifest and marketplace entry.
  • .codex-plugin/plugin.json — Codex plugin manifest.
  • .cursor-plugin/plugin.json + .cursor-plugin/marketplace.json — Cursor Agent CLI/IDE manifest and marketplace entry.
  • plugin.yaml + __init__.py — Hermes manifest and Python registration adapter. It registers the shared skills read-only under the ai-agents-skills: namespace and maps compatible lifecycle hooks.
  • package.json + extensions/prime-adapter.ts — Prime Agent capability-package manifest and lifecycle adapter. It exposes skills/ and agents/ through the Prime package resource API, then maps only lifecycle events Prime supports.

Conventions

  • Shared skills live under skills/ and are used by all four integrations — don't fork or duplicate a skill per runtime.
  • Runtime-specific lifecycle hook maps stay separate: hooks/hooks.json (Claude Code), hooks/codex-hooks.json (Codex, declared explicitly in .codex-plugin/plugin.json), and hooks/cursor-hooks.json (Cursor — routes every event through hooks/cursor-adapter.sh, which normalizes Cursor's payload field names into the shape the shared tg-*.sh/abbr-inject.sh scripts already expect). Do not merge them, and put any Cursor-specific translation logic in the adapter, not in the shared scripts. Cursor has no Notification/PermissionRequest equivalent — the "needs attention" ping is intentionally not wired for Cursor; see docs/superpowers/specs/2026-07-31-cursor-plugin-design.md.
  • Hermes lifecycle translation belongs in the root __init__.py; shared shell hooks continue to consume the normalized Claude-shaped JSON payload. Hermes has no permission/idle notification event, so that ping degrades safely just as it does under Cursor.
  • When changing shared behavior (a skill, an agent, a hook script), preserve all five integrations — verify the change still works for Claude Code, Codex, Cursor, Hermes, and Prime Agent, and update every manifest the change affects metadata for (e.g. version).
  • Codex hooks must be declared explicitly as ./hooks/codex-hooks.json so Codex does not auto-discover the Claude Code-specific hooks/hooks.json. Plugin hooks require the user's Codex trust review before they can execute.
  • Script-bearing skills must resolve the root through AI_AGENTS_SKILLS_ROOT, with Claude/Codex/Cursor root fallbacks. Hermes sets AI_AGENTS_SKILLS_ROOT during plugin registration.
  • Run pytest -q tests/test_hermes_plugin.py and an isolated hermes plugins install file://... --enable smoke test for Hermes changes.
  • All authored repository text (skills, docs, manifests, commit messages) is English.
  • See README.md for install/enable/verify steps for each runtime.

Read the full file on GitHub · 52 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. 8d ago First seen · 52 lines · 733 tokens per session scan A a8260ec84aac

Subscribe to this mod's changes

ai-agents-skills AGENTS.md is an instructions file published in the GitHub repository Xakki/ai-agents-skills (6 stars, last pushed 18d ago), licensed MIT. It adds 733 tokens to every session, about $0.0037 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.

Related

Other instructions, from other repositories

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,153 tokens

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,469 tokens

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,104 tokens