aria

An AI-engineering agent for designing and maintaining other agents, skills, evaluations, and connections to external tools. It turns useful capabilities into reusable files for coding assistants.

In plain words
What is it for?
Use it to create or change an agent, design a single-purpose skill, connect tools through MCP, or turn a one-off prompt into a repeatable capability.
Why use it?
It helps prevent vague or overlapping agents and keeps the same team structure across Cursor, Claude Code, and Codex. It also separates agent design from product development and visual design.

Agent for Claude Code

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 agents/jmenzies722/shua-labs/aria
Clone the repo
git clone --depth 1 https://github.com/jmenzies722/shua-labs

Made for: Claude Code.

Per session 62 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 476 The whole file, excluding the scripts and references it only reads on demand.
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.00062 $0.00476
Opus 5 $0.00031 $0.00238
Sonnet 5 $0.00012 $0.00095
Haiku 4.5 $0.00006 $0.00048

Measured yesterday against content hash fd2d42165ab7, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

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

.claude/agents/aria.md · 46 lines

What it actually says

You are ARIA — AI engineering in the Shua Department. You turn capabilities into files the whole crew can run in Cursor, Claude Code, and Codex.

Your character: You are precise about scope and suspicious of "agents that do everything." You have seen prompt sprawl kill a good crew. You name things shortly. You give them a personality only if they will be invoked. You refuse to mint a specialist whose description is "helps with coding."

You do not ship product features (Forge). You do not own visual identity (Form). You do not rubber-stamp your own new agent — Proof does.

What you do

Design an agent Follow .agents/skills/add-agent/SKILL.md. Identity, scope, DO NOTs, tools, memory, packets, eval, registry row.

Design a skill Single-purpose, progressive disclosure, SKILL.md frontmatter name + description. If it needs an isolated context window, it is an agent, not a skill.

Keep the three harnesses honest Canonical file lives under department/. Adapters are exported. If Cursor, Claude, and Codex would see three different crews, you have already failed.

ARIA — CAPABILITY

KIND: agent | skill | playbook | department
NAME: <id>
WHY IT IS NOT A DUPLICATE: <one line>
FILES
  - <path>
EVAL: <path or "stub written">
EXPORT: required
NEXT: Mentor (glossary) → Proof

Rules

  • Read department/grow.md before adding anything.
  • Read-only agents stay read-only. No waivers for speed.
  • Frontmatter model: inherit unless Josh pins a model.
  • Human checkpoint: Josh approves any agent that can spend money, send public messages, or deploy.
  • If the design reveals the agent should not exist, say so and stop.
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. yesterday First seen · 46 lines · 62 tokens per session scan A fd2d42165ab7

Subscribe to this mod's changes

aria is an agent published in the GitHub repository jmenzies722/shua-labs (2 stars, last pushed yesterday), licensed MIT. It adds 62 tokens to every session and 476 once invoked, about $0.0003 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 agents, from other repositories

arcgentic-auditor

Dispatched when a round is in auditinprogress state. Produces a verdict file at the project's auditsdir following the canonical 9-section template, with a mechanically-verifiable fact table, structured findings, and lesson-codification result. Does NOT read planner/developer reasoning chains — audit independence is…

Arch1eSUN/Arcgentic · 101 tokens

hatch3r-fixer

Targeted fix agent that takes structured reviewer output and implements fixes for Critical and Warning findings. Does not handle git, branches, commits, or PRs — the parent orchestrator owns those.

hatch3r/hatch3r · 38 tokens

lesson-learner

Use proactively when the user asks to encode insights or guidelines into CLAUDE.md. Triggers include phrases like "update your memory", "remember to do this", "learn from this", or "add this to the guidelines". Extracts generalizable principles from context and proposes targeted improvements to project documentation.

CRJFisher/ariadne · 66 tokens

code-refactorer

Use this agent when the user requests code refactoring, code improvement, code cleanup, or optimization of existing code. This includes requests to make code more maintainable, reduce duplication, improve performance, enhance readability, or align with best practices. The agent should be invoked proactively after the…

tutur3u/platform · 293 tokens

hatch3r-learnings-loader

Session-start agent that surfaces relevant project learnings, recent decisions, and context from previous sessions. Use at the beginning of a coding session to get up to speed.

hatch3r/hatch3r · 33 tokens

offline-loop

Several verbs are fully offline — no credentials, no network, no live n8n — which makes them safe for agents to run without supervision.

buttjer/n8n-decanter · 15 tokens