ai-engineering: Skill for Claude Code

.agents/skills/ai-report/SKILL.md

ai-report is a skill for Claude Code from arcasilesgroup/ai-engineering. It costs 132 tokens per session (688 once invoked), scanned A, original, Apache-2.0.

A workflow for reporting a reproducible bug in this framework as a small local draft with a title, description, expected result, and reproduction steps.

In plain words
What is it for?
Recording framework bugs, describing what happened and what should have happened, adding reproduction steps, and checking that the report contains no sensitive values.
Why use it?
It gives maintainers an actionable report while excluding logs, command lines, secrets, personal data, and machine paths.

Skill for Claude Code

Written for Claude Code: disable-model-invocation in frontmatter. Also seen: installed under .agents/ (shared by several agents).

This is arcasilesgroup/ai-engineering's own configuration. It tells Claude Code how to work on ai-engineering 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-engineering configures →

Reuse

Borrowing it

Nothing to install: this file belongs to arcasilesgroup/ai-engineering. 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/arcasilesgroup/ai-engineering/main/.agents/skills/ai-report/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/arcasilesgroup/ai-engineering

Made for: Claude Code.

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-report

README.md
[![agentmods](https://agentmods.dev/badge/skills/arcasilesgroup/ai-engineering/ai-report.svg)](https://agentmods.dev/skills/arcasilesgroup/ai-engineering/ai-report)
Your own site
<a href="https://agentmods.dev/skills/arcasilesgroup/ai-engineering/ai-report"><img src="https://agentmods.dev/badge/skills/arcasilesgroup/ai-engineering/ai-report.svg" alt="Measured on agentmods" height="20"></a>
Per session 132 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 688 The whole file, excluding the scripts and references it only reads on demand.
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.00132 $0.00688
Opus 5 $0.00066 $0.00344
Sonnet 5 $0.00026 $0.00138
Haiku 4.5 $0.00013 $0.00069

Measured 7d ago against content hash 5d887593ad43, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

ai-report 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 7d 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/skills/ai-report/SKILL.md · 56 lines

How it starts

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

Report the framework's own fault, and collect nothing on the way

What it produces

.ai/issue/draft.json — local, gitignored, previewed byte for byte, and sent by nobody but you.

Steps

  1. Reproduce it first. A report of something that happened once is a report the person reading it cannot act on, and the steps field is what makes the difference.

  2. Decide the kind before you write. --kind security never becomes a public issue: the command refuses that route before it asks you anything, and prints the private one.

  3. Write the four fields in your own words: the title, what happened, what you expected, and one --step per step. Never paste a log, a diff, a traceback or a command line — there is no field for any of them, and a pasted command carries the path it ran from.

  4. Run it:

    ai-eng report issue --kind bug --title "…" --what-happened "…" \
      --expected "…" --step "…" --step "…"
    
  5. Read the refusal if you get one. ACCEPTANCE_MACHINE_PATH_*, ACCEPTANCE_PII_* and ACCEPTANCE_GITLEAKS_SECRET each name what was found, no draft is written, and the fix is to say the same thing without the value it carried.

  6. Read the bytes it prints. They are exactly what would leave, and the SHA-256 beside them is of those bytes. If anything in there is not yours to publish, stop.

  7. Sending is separate and manual. --submit asks for a phrase carrying that digest at your keyboard, and then says there is nowhere to send: no destination is configured and this package has no transport. Take the previewed bytes to the route your organisation uses.

What this is not

  • "The fault is obvious, so the report needs no reproduction steps" — a report of something that happened once is a report the person reading it cannot act on, and the steps field is what makes the difference.

Done when

  • Every field is a sentence you wrote, and nothing in the payload was collected.
  • The scan came back clean, or you rewrote the field it named rather than working around it.
  • A vulnerability went to private disclosure and no public issue exists for it.

Read the full file on GitHub · 56 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 7d ago First seen · 56 lines · 132 tokens per session scan A 5d887593ad43

Subscribe to this mod's changes

ai-report is a skill published in the GitHub repository arcasilesgroup/ai-engineering (54 stars, last pushed 5d ago), licensed Apache-2.0. It adds 132 tokens to every session and 688 once invoked, about $0.0007 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.

Related

Other skills, from other repositories

hotfix

Fixes an observed defect with reproducible evidence in one call: writes a short trace doc before touching code, implements the fix, and backs it with a regression test written before the fix. Production incidents are the motivating case, not a gate. When blocked, it halts by name and saves the doc for a later call to…

pe-menezes/vibeflow · 102 tokens

okteto-debugging

Use when the user describes a broken or unhealthy Okteto environment. Triggers on phrases like: "service is crashing", "service keeps restarting", "service won't start", "environment is broken", "deployment is failing", "pods are stuck", "pods are not ready", "pods are pending", "CrashLoopBackOff", "OOMKilled"…

okteto/okteto-agent-skills · 151 tokens

phoenix-doctor

Diagnose and repair a Phoenix install with the same objective discipline Phoenix gives the agent — check whether the installed agent, skills, and MCP registration match what this build ships, and re-sync any drift with a snapshot-backed fix that is re-verified red→green. Use when Copilot says "No such agent: phoenix"…

All-The-Vibes/ATV-Phoenix · 113 tokens

phoenix-build

Implement one planned step at a time under the verify-heal loop — snapshot before risky edits, make the smallest change, sense the objective check, and heal (rollback or retry) if it goes red. Never advance to the next step on a red check, never claim a step done without a green sense. Use during implementation, or…

All-The-Vibes/ATV-Phoenix · 90 tokens

phoenix-debug

Systematic triage and self-healing when something breaks — reproduce with an objective check first, isolate the cause with the code graph, fix the root not the symptom, and confirm with phoenixsense before claiming it resolved. Use when a test/build is red, a regression appears, or the user says /phoenix-debug, "it…

All-The-Vibes/ATV-Phoenix · 80 tokens

phoenix-self-heal

The core verify-then-heal loop usable on its own for any change with a checkable outcome — sense success objectively, snapshot known-good state, and recover (bounded rollback or retry) when a check goes red, confirmed by an external recheck. Use whenever you make a change that has a runnable test/build/lint, or when…

All-The-Vibes/ATV-Phoenix · 96 tokens