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

Using Arcgentic

by Arch1eSUN in Arch1eSUN/Arcgentic

Entry skill for the arcgentic plugin — establishes the four-role workflow (planning / dev+self-audit / external-audit / reference-tracking), the round state machine, and when to switch roles or…

MITAuto-check passedAgent Workflows

Install Using Arcgentic

skills CLI
$ npx skills add Arch1eSUN/Arcgentic --skill using-arcgentic -a claude-code

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

GitHub CLI
$ gh skill install Arch1eSUN/Arcgentic using-arcgentic --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/Arch1eSUN/Arcgentic.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/using-arcgentic .claude/skills/using-arcgentic && 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
using-arcgentic
GitHub stars
286
Token cost
~1.5k tokens
SKILL.md length
534 words
Files
1
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

Entry skill for the arcgentic plugin — establishes the four-role workflow (planning / dev+self-audit / external-audit / reference-tracking), the round state machine, and when to switch roles or…

  • Works in 3 steps: Verifies the target is in the current… → Runs the required gate script (reject if… → Updates current_round.state + appends to…
  • Starting any session in a project that has .agentic-rounds/state.yaml present
  • SKILL.md covers Overview, The Iron Rule, The Four Roles and Two Operating Modes, plus 7 more sections
  • Calls bash

What it does

Using Arcgentic is an agent skill from Arch1eSUN/Arcgentic. Entry skill for the arcgentic plugin — establishes the four-role workflow (planning / dev+self-audit / external-audit / reference-tracking), the round state machine, and when to switch roles or dispatch sub-agents. Use when starting any session in a project that has .agentic-rounds/state.yaml present, OR when the user mentions arcgentic / round-driven development / external audit / four-role workflow.

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

It sits in Agent Workflows, covering Subagents. The repository describes itself as: Mechanical plan/dev/self-audit/external-audit gates for AI coding agents, with a configurable role-routing topology engine, an MCP-UI live status panel, and native-tooling Claude… The licence is MIT.

When your agent uses it

  • Starting any session in a project that has .agentic-rounds/state.yaml present
  • When the user mentions arcgentic / round-driven development / external audit / four-role workflow

Example prompts

  • “/using-arcgentic”

Workflow steps

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

  1. Verifies the target is in the current state's next list (reject if not)
  2. Runs the required gate script (reject if not 0)
  3. Updates current_round.state + appends to state_history

What it can do on your machine

Read from SKILL.md and the folder at commit 8539955. 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

    Shell commands in SKILL.md call:

    • bash

    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.

Context cost

Using Arcgentic loads about 1.5k tokens when it runs. Until then it costs about 105 tokens; SKILL.md has 534 words of instructions outside code blocks.

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

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 Arch1eSUN/Arcgentic at commit 8539955, republished under its MIT licence (© Arch1eSUN). 534 words, ~1,459 tokens.

Download SKILL.mdSave it as .claude/skills/using-arcgentic/SKILL.md (or your agent's skills folder).
name
using-arcgentic
description
Entry skill for the arcgentic plugin — establishes the four-role workflow (planning / dev+self-audit / external-audit / reference-tracking), the round state machine, and when to switch roles or dispatch sub-agents. Use when starting any session in a project that has .agentic-rounds/state.yaml present, OR when the user mentions arcgentic / round-driven development / external audit / four-role workflow.

Using arcgentic

Overview

arcgentic is an agentic harness for round-driven development. It turns the four-role engineering workflow into a mechanically-enforced state machine where every transition is gated, every artifact is structured, and every lesson is codified.

Announce at start: "I'm using the arcgentic:using-arcgentic skill to navigate the round workflow."

The Iron Rule

BEFORE ANY ACTION IN A ROUND-DRIVEN PROJECT:
1. Read .agentic-rounds/state.yaml (single source of truth)
2. Run scripts/state/pickup.sh — get your role + action
3. Load the role-specific skill if applicable
4. Then act

The Four Roles

RoleWhenSkillState
plannerRound intake → handoff docarcgentic:plan-roundintake, planning
developerHandoff → commit chainarcgentic:execute-rounddev_in_progress, fix_in_progress
auditorCommits → verdictarcgentic:audit-roundawaiting_audit, audit_in_progress
closeoutPASS verdict → anchored closearcgentic:close-roundpassed
ref-trackerDaily git fetch + categorizearcgentic:track-refs(continuous)

Each role has a dedicated skill. In multi-session mode, load only the skill for the role named by state/pickup or by arcgentic session-mode prompt --role.

Two Operating Modes

Mode A — Single-session (orchestrator drives all)

Main session loads arcgentic:orchestrate-round. Acts as orchestrator. Dispatches sub-agents (orchestrator.md → auditor.md → ...) via Claude Code's Task tool when role-switching is needed. State machine advances after each sub-agent's structured output is verified.

Use when: independent developer / small project / no team coordination needed.

Mode B — Multi-session (humans coordinate)

Each role runs in its own Claude session. Each session loads only its role's skill. State.yaml is the inter-session protocol — every session starts by reading it.

Use when: team of humans / different humans want different role contexts / role-specific skill loading must not contaminate other role's contexts.

Both modes share the same state.yaml schema and the same gate scripts. The mode is a project-level decision in project.session_mode; do not ask again per round once it is set.

State Machine

intake → planning → awaiting_dev_start → dev_in_progress → awaiting_audit
                                                                 ↓
                                  closed ← passed ←———— audit_in_progress
                                                                 ↓
                                  awaiting_audit ← fix_in_progress ← needs_fix

Every transition runs scripts/state/transition.sh, which:

  1. Verifies the target is in the current state's next list (reject if not)
  2. Runs the required gate script (reject if not 0)
  3. Updates current_round.state + appends to state_history

Gates:

  • planning → awaiting_dev_start requires handoff-doc-gate.sh
  • dev_in_progress → awaiting_audit requires round-commit-chain-gate.sh
  • fix_in_progress → awaiting_audit requires round-commit-chain-gate.sh
  • audit_in_progress → passed | needs_fix requires verdict-fact-table-gate.sh
  • passed → closed is owned by arcgentic close-round, which checks verdict completeness and strict audit-check before writing the closed state
Show full SKILL.md (211 more words)Show less

What to do RIGHT NOW

The literal first thing to do, every session:

bash
bash $PLUGIN_ROOT/scripts/state/pickup.sh --state-file ./.agentic-rounds/state.yaml

($PLUGIN_ROOT is where this plugin is installed; on Claude Code default: ~/.claude/plugins/arcgentic/)

The pickup output tells you which role + which action. Then load the corresponding skill or follow the handoff doc.

Bootstrap (new project)

If .agentic-rounds/state.yaml doesn't exist:

bash
bash $PLUGIN_ROOT/scripts/state/init.sh \
  --project-root . \
  --project-name "<your-project-name>" \
  --round-naming "<your-naming-pattern, e.g. phase.round[.fix]>"

This creates the state.yaml in intake state. You're ready.

Cost Discipline (load-bearing)

arcgentic never:

  • Calls paid APIs from its scripts
  • Starts background processes / daemons / cron
  • Pulls references automatically (founder/user triggers refresh-references.sh manually)

If a sub-agent dispatched via Task tool tries to break any of these, refuse + report.

When NOT to use arcgentic

  • One-off scripts / throwaway prototypes (overhead > value)
  • Projects where every change ships without review (no audit role needed)
  • Hobby projects without a "PASS gate" notion (the round model assumes that)

Skill priority (when multiple apply)

  1. arcgentic:using-arcgentic (this skill) is the orientation skill — always load first in an arcgentic project
  2. Then load the role skill matching pickup.sh output
  3. arcgentic:pre-round-scan is invoked by role skills as their first action; you don't need to load it manually
  4. arcgentic:verify-gates is invoked by the state-machine scripts, not directly by you

See also

  • skills/orchestrate-round/SKILL.md — for orchestrator mode
  • skills/audit-round/SKILL.md — for auditor role
  • skills/close-round/SKILL.md — for PASS-only closeout
  • docs/examples/state.example.yaml — schema reference
  • schema/state.schema.json — JSON Schema

© Arch1eSUN, 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 skills/using-arcgentic of Arch1eSUN/Arcgentic.

Open the folder on GitHubat commit 8539955

Compare with similar skills

Using Arcgentic 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.

Using Arcgentic compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Using Arcgentic this skillArch1eSUN/Arcgentic286—~1.5kAutomated safety check: PassMIT
Claude Code Agent Developmentanthropics/claude-plugins-official38k8 repos~2.8kAutomated safety check: PassApache-2.0
Subagent Driven DevelopmentAsvarox/allkaraoke26138 repos~1.2kAutomated safety check: PassNone
Dispatching Parallel Agentsultralisp/ultralisp25841 repos~1.5kAutomated safety check: PassNone
Paseo Advisor Second Opiniongetpaseo/paseo20k1 repos~756Automated safety check: PassCustom licence
Task Observerrebelytics/one-skill-to-rule-them-all3.2k1 repos~12kAutomated safety check: PassCC-BY-4.0

Similar skills

  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    38k GitHub starsUsed in 8 repos~2.8k tokens
    Agent WorkflowsAuto-check passed

  • Subagent Driven Development

    Asvarox/allkaraoke

    A skill your agent uses when executing implementation plans with independent tasks in the current session

    261 GitHub starsUsed in 38 repos~1.2k tokens
    Agent WorkflowsAuto-check passed

  • Dispatching Parallel Agents

    ultralisp/ultralisp

    A skill your agent uses when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies

    258 GitHub starsUsed in 41 repos~1.5k tokens
    Agent WorkflowsAuto-check passed

  • Paseo Advisor Second Opinion

    getpaseo/paseo

    Launches one separate agent through Paseo to give a second opinion on the current task, with a self-contained briefing and no permission to edit files.

    20k GitHub starsUsed in 1 repo~756 tokens
    Agent WorkflowsAuto-check passed

  • Task Observer

    rebelytics/one-skill-to-rule-them-all

    Monitors task execution for skill improvement opportunities.

    3.2k GitHub starsUsed in 1 repo~12k tokens
    Agent WorkflowsAuto-check passed

  • O2 Review Loop

    openobserve/openobserve

    Splits a change into planner, coder and independent reviewer roles: you confirm a spec, a subagent implements it, and a separate reviewer checks each round's local WIP commit.

    22k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from Arch1eSUN/Arcgentic

All 19 skills in this repo

  • Audit Round

    Arch1eSUN/Arcgentic

    External-audit role for arcgentic rounds. An agent skill from Arch1eSUN/Arcgentic.

    286 GitHub stars~1.6k tokensUpdated 6 days ago
    Auto-check passed

  • Orchestrate Round

    Arch1eSUN/Arcgentic

    Main-session orchestrator for arcgentic rounds. An agent skill from Arch1eSUN/Arcgentic.

    286 GitHub stars~1.5k tokensUpdated 6 days ago
    Auto-check passed

  • Verify Gates

    Arch1eSUN/Arcgentic

    Runs the mechanical quality gates that the arcgentic state machine requires for state transitions.

    286 GitHub stars~653 tokensUpdated 6 days ago
    Auto-check passed

  • Arcgentic

    Arch1eSUN/Arcgentic

    A skill your agent uses when the user mentions Arcgentic, or wants substantial AI-written code taken through a gated plan → development → self-audit → external audit workflow with role handoffs and…

    286 GitHub stars~984 tokensUpdated 6 days ago
    Auto-check passed

  • Arcgentic

    Arch1eSUN/Arcgentic

    A skill your agent uses when the user says Arcgentic, asks to use Arcgentic, or wants an idea taken through a complete plan → development → self-audit → external audit workflow in Codex.

    286 GitHub stars~2.4k tokensUpdated 6 days ago
    Auto-check passed

  • Claude Code Session Broker

    Arch1eSUN/Arcgentic

    A skill your agent uses when running Arcgentic V2 in Claude Code and fixed Planner, Developer, and Auditor role sessions must be coordinated through a broker.

    286 GitHub stars~3.4k tokensUpdated 6 days ago
    Auto-check passed

Categories

Questions about Using Arcgentic

What does Using Arcgentic do?

Entry skill for the arcgentic plugin — establishes the four-role workflow (planning / dev+self-audit / external-audit / reference-tracking), the round state machine, and when to switch roles or…. Using Arcgentic is an agent skill from Arch1eSUN/Arcgentic. Entry skill for the arcgentic plugin — establishes the four-role workflow (planning / dev+self-audit / external-audit / reference-tracking), the round state machine, and when to switch roles or dispatch sub-agents.

When should I use Using Arcgentic?

Using Arcgentic fits situations like: starting any session in a project that has .agentic-rounds/state.yaml present; when the user mentions arcgentic / round-driven development / external audit / four-role workflow.

How do I install Using Arcgentic in Claude Code?

Run `npx skills add Arch1eSUN/Arcgentic --skill using-arcgentic -a claude-code`. Or copy the skill folder (skills/using-arcgentic in Arch1eSUN/Arcgentic) into .claude/skills/using-arcgentic in your project. Claude Code loads it when a task matches its description.

How do I install Using Arcgentic in Codex?

Run `npx skills add Arch1eSUN/Arcgentic --skill using-arcgentic -a codex`. Or copy the skill folder (skills/using-arcgentic in Arch1eSUN/Arcgentic) into .agents/skills/using-arcgentic in your project. Codex loads it when a task matches its description.

Can I use Using Arcgentic 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 Arch1eSUN/Arcgentic --skill using-arcgentic -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/using-arcgentic, .gemini/skills/using-arcgentic, .github/skills/using-arcgentic and .opencode/skills/using-arcgentic in your project.

What does Using Arcgentic need to run?

Going by SKILL.md and its folder, Using Arcgentic needs the command-line tools its instructions call (bash).

Does Using Arcgentic 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 Using Arcgentic 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 Using Arcgentic use?

Using Arcgentic 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 Using Arcgentic use?

About 1.5k tokens (SKILL.md is roughly 5.8k 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 Using Arcgentic?

Skills that share tags, products or a category with Using Arcgentic: Claude Code Agent Development (anthropics/claude-plugins-official, 38k stars), Subagent Driven Development (Asvarox/allkaraoke, 261 stars), Dispatching Parallel Agents (ultralisp/ultralisp, 258 stars) and Paseo Advisor Second Opinion (getpaseo/paseo, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Using Arcgentic?

Arch1eSUN (a GitHub user) maintains it in Arch1eSUN/Arcgentic, which has 286 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 2, 2026.

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