New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Ax Annotation

by autopus-ai in autopus-ai/autopus-adk

@AX code annotation workflow skill for agent-driven tag application

MITAuto-check passed

Install Ax Annotation

skills CLI
$ npx skills add autopus-ai/autopus-adk --skill ax-annotation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install autopus-ai/autopus-adk ax-annotation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/autopus-ai/autopus-adk.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.omp/skills/ax-annotation .claude/skills/ax-annotation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ax-annotation
GitHub stars
110
Token cost
~1k tokens
SKILL.md length
558 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

@AX code annotation workflow skill for agent-driven tag application

  • Works in 7 steps: Scan — list all files modified in this… → Detect triggers — for each file, check… → Draft tags — prefix every… → …
  • SKILL.md covers Activation, Canonical Source, When to Apply @AX Tags and Application Workflow, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Ax Annotation is an agent skill from autopus-ai/autopus-adk. @AX code annotation workflow skill for agent-driven tag application

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: omp

The repository describes itself as: Autopus-ADK is of the agents, by the agents. for the agents. Multi-model orchestration (consensus/pipeline/debate/fastest). Architecture-as-Code, Lore decision tracking… The licence is MIT.

Example prompts

  • “/ax-annotation”

Requirements

  • Compatibility (from SKILL.md): omp

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Scan — list all files modified in this task
  2. Detect triggers — for each file, check NOTE / WARN / ANCHOR / TODO conditions above
  3. Draft tags — prefix every agent-generated tag with [AUTO]
  4. Attach REASON — add @AX:REASON immediately after every WARN and ANCHOR tag
  5. Count per-file — verify ANCHOR <= 3 and WARN <= 5 per file
  6. Handle overflow — apply overflow strategy (see below)
  7. Commit — include tags in the same commit as the code change

What it can do on your machine

Read from SKILL.md and the folder at commit a930e5f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are go).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    omp

    From compatibility in the SKILL.md frontmatter.

Context cost

Ax Annotation loads about 1k tokens when it runs. Until then it costs about 20 tokens; SKILL.md has 558 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~20
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from autopus-ai/autopus-adk at commit a930e5f, republished under its MIT licence (© autopus-ai). 558 words, ~1,043 tokens.

Download SKILL.mdSave it as .claude/skills/ax-annotation/SKILL.md (or your agent's skills folder).
name
ax-annotation
description
@AX code annotation workflow skill for agent-driven tag application
compatibility
omp

@AX Annotation Skill

The canonical @AX rule set is emitted into this skill by the harness generator, so the tag definitions, trigger conditions, lifecycle rules, and per-file limits below are authoritative for this installation. This skill provides actionable guidance for WHEN and HOW agents apply @AX tags.

Activation

@AX annotation is opt-in. It is not a pipeline phase and no workflow tags files on its own.

Run it only when one of these is true:

  • the user asks for @AX tags, or names this skill;
  • the run passes the annotation opt-in, so auto spec gates <SPEC-ID> --annotation evaluates the annotation gate and returns required.

Without that opt-in the annotation gate is not_applicable, the pipeline records no annotation step, and completion evidence reads @AX: not requested. A repository that has never adopted @AX therefore stays untagged instead of accumulating machine-authored comments nobody asked for.

When the gate is opted in but the reference source or the annotator surface is missing, report blocked with the fallback "record modified files, defer tagging" rather than looping. Nothing to annotate is not_applicable, not blocked.

Canonical Source

Do NOT redefine tag rules elsewhere. Treat the sections of this document as the single source and apply them as written.

When to Apply @AX Tags

NOTE Triggers

Apply @AX:NOTE when you encounter:

  • A magic constant with no explanation
  • An exported function over 100 lines that has no godoc comment
  • A business rule that is not self-evident from the code
WARN Triggers

Apply @AX:WARN (with @AX:REASON) when you detect:

  • A goroutine or channel launched without a context.Context
  • Cyclomatic complexity >= 15 (check with gocyclo or manual count)
  • Mutation of a package-level or global variable
  • A function with 8 or more if branches
ANCHOR Triggers

Apply @AX:ANCHOR (with @AX:REASON) when:

  • A function has fan_in >= 3 callers (heuristic: grep -r "FuncName(" . | wc -l)
  • Removing or renaming the symbol would break multiple consumers
TODO Triggers

Apply @AX:TODO when:

  • A public function has no corresponding test file
  • A SPEC requirement is referenced but not yet implemented
  • An error is returned without handling (silent discard)
Show full SKILL.md (218 more words)Show less

Application Workflow

Execute after the GREEN or REFACTOR phase of TDD, once the opt-in above is satisfied:

  1. Scan — list all files modified in this task
  2. Detect triggers — for each file, check NOTE / WARN / ANCHOR / TODO conditions above
  3. Draft tags — prefix every agent-generated tag with [AUTO]
  4. Attach REASON — add @AX:REASON immediately after every WARN and ANCHOR tag
  5. Count per-file — verify ANCHOR <= 3 and WARN <= 5 per file
  6. Handle overflow — apply overflow strategy (see below)
  7. Commit — include tags in the same commit as the code change

Per-File Limits and Overflow

TagLimitOverflow Strategy
ANCHOR3 per fileDowngrade the entry with the lowest fan_in count to NOTE
WARN5 per fileRetain the 5 highest-priority (oldest / most severe); drop new candidates

When a downgrade occurs, add a comment: // @AX:NOTE: [downgraded from ANCHOR — fan_in < threshold]

[AUTO] Prefix Rule

Every tag inserted by an agent MUST begin with [AUTO]:

go
// @AX:NOTE [AUTO]: Magic constant — see payment SLA documentation
const retryLimit = 3

Human-authored tags omit [AUTO]. Never remove an existing [AUTO] prefix.

@AX:CYCLE Tracking

@AX:TODO tags that survive 3 or more TDD cycles without resolution must be escalated to @AX:WARN. Cycle count is tracked via a sync comment on the tag line:

go
// @AX:TODO [AUTO] @AX:CYCLE:2: Add input validation — SPEC-AUTH-001

When CYCLE reaches 3, replace the TODO with a WARN and add @AX:REASON.

Language-Specific Comment Syntax

LanguagePrefix
Go, Java, TypeScript, Rust//
Python, Ruby#
Haskell--

© autopus-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .omp/skills/ax-annotation of autopus-ai/autopus-adk.

Open the folder on GitHubat commit a930e5f

Compare with similar skills

Ax Annotation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ax Annotation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ax Annotation this skillautopus-ai/autopus-adk110—~1kAutomated safety check: PassMIT
Wireframe Annotatednexu-io/open-design100k—~960Automated safety check: PassApache-2.0
Review Tagshashicorp/terraform-provider-aws11k—~462Automated safety check: PassMPL-2.0
Arize Annotationgithub/awesome-copilot40k1 repos~2.7kAutomated safety check: NotesMIT
Image Annotationsgithub/awesome-copilot40k—~6kAutomated safety check: PassMIT
Plannotator Annotatebacknotprop/plannotator9.3k—~163Automated safety check: PassApache-2.0

Similar skills

  • Wireframe Annotated

    nexu-io/open-design

    An annotated / redline lo-fi wireframe — a desktop landing/marketing page drawn as flat greyboxes inside a browser chrome frame, overlaid with numbered annotation pins (①②③④⑤) in a single accent…

    100k GitHub stars~960 tokensUpdated today
    Frontend & DesignAuto-check passed

  • Review Tags

    hashicorp/terraform-provider-aws

    Official

    Review Terraform AWS Provider tagging: the tags/tagsall schema attributes, the @Tags(identifierAttribute=...) annotation, and wiring input.Tags = getTagsIn(ctx) after flex.Expand.

    11k GitHub stars~462 tokensUpdated today
    DevOps & CloudAuto-check passed

  • Arize Annotation

    github/awesome-copilot

    Official

    Creates and manages annotation configs (categorical, continuous, freeform label schemas) and annotation queues (human review workflows) on Arize.

    40k GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check: notes

  • Image Annotations

    github/awesome-copilot

    Official

    Annotate screenshots, diagrams, and images with callout rectangles, arrows, labels, and color-coded highlights using PIL.

    40k GitHub stars~6k tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Plannotator Annotate

    backnotprop/plannotator

    Open Plannotator's annotation UI for a file, folder, or URL, then address the returned annotations.

    9.3k GitHub stars~163 tokensUpdated today
    Auto-check passed

  • Noscript Tag

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing templates, rendered HTML, or shared components related to Provide noscript fallback content.

    74k GitHub stars~554 tokensUpdated 4 days ago
    Auto-check passed

More from autopus-ai/autopus-adk

All 11 skills in this repo

  • Auto Idea

    autopus-ai/autopus-adk

    아이디어 브레인스토밍 — 멀티 프로바이더 토론과 ICE 평가로 아이디어를 정리합니다. An agent skill from autopus-ai/autopus-adk.

    110 GitHub stars~2.4k tokensUpdated today
    Auto-check passed

  • Auto QA

    autopus-ai/autopus-adk

    QAMESH project QA mesh — plan, run, report, and publish deterministic QA evidence

    110 GitHub stars~2.7k tokensUpdated today
    Auto-check passed

  • Auto Setup

    autopus-ai/autopus-adk

    프로젝트 컨텍스트 생성 — 코드베이스를 분석하고 ARCHITECTURE.md 및 .autopus/project 문서를 생성합니다

    110 GitHub stars~1.5k tokensUpdated today
    Auto-check passed

  • Auto Sync

    autopus-ai/autopus-adk

    문서 동기화 — 구현 이후 SPEC, CHANGELOG, 문서를 반영합니다. An agent skill from autopus-ai/autopus-adk.

    110 GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Browser Automation

    autopus-ai/autopus-adk

    터미널 환경 자동 감지 브라우저 자동화 스킬 — AI 에이전트가 직접 웹 페이지를 조작하고 검증. An agent skill from autopus-ai/autopus-adk.

    110 GitHub stars~2.1k tokensUpdated today
    Auto-check passed

  • Codebase Design

    autopus-ai/autopus-adk

    작은 인터페이스 뒤에 많은 동작을 숨기는 deep module을 설계하기 위한 공용 어휘(module, interface, seam, adapter, depth)와 원칙

    110 GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Questions about Ax Annotation

What does Ax Annotation do?

@AX code annotation workflow skill for agent-driven tag application. Ax Annotation is an agent skill from autopus-ai/autopus-adk.

How do I install Ax Annotation in Claude Code?

Run `npx skills add autopus-ai/autopus-adk --skill ax-annotation -a claude-code`. Or copy the skill folder (.omp/skills/ax-annotation in autopus-ai/autopus-adk) into .claude/skills/ax-annotation in your project. Claude Code loads it when a task matches its description.

How do I install Ax Annotation in Codex?

Run `npx skills add autopus-ai/autopus-adk --skill ax-annotation -a codex`. Or copy the skill folder (.omp/skills/ax-annotation in autopus-ai/autopus-adk) into .agents/skills/ax-annotation in your project. Codex loads it when a task matches its description.

Can I use Ax Annotation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add autopus-ai/autopus-adk --skill ax-annotation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ax-annotation, .gemini/skills/ax-annotation, .github/skills/ax-annotation and .opencode/skills/ax-annotation in your project.

What does Ax Annotation need to run?

SKILL.md names no scripts, command-line tools or credentials: Ax Annotation is instructions for the agent only. Compatibility (from SKILL.md): omp.

Does Ax Annotation access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ax Annotation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ax Annotation use?

Ax Annotation is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ax Annotation use?

About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ax Annotation?

Skills that share tags, products or a category with Ax Annotation: Wireframe Annotated (nexu-io/open-design, 100k stars), Review Tags (hashicorp/terraform-provider-aws, 11k stars), Arize Annotation (github/awesome-copilot, 40k stars) and Image Annotations (github/awesome-copilot, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ax Annotation?

autopus-ai (a GitHub organization) maintains it in autopus-ai/autopus-adk, which has 110 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 10, 2026.

Source: autopus-ai/autopus-adk on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.