Agent skill

Agent Architect

by IgorWarzocha in IgorWarzocha/Opencode-Workflows

Create and refine OpenCode agents via guided Q&A. An agent skill from IgorWarzocha/Opencode-Workflows.

No licenceAuto-check passedAgent Workflows

Install Agent Architect

skills CLI
$ npx skills add IgorWarzocha/Opencode-Workflows --skill agent-architect -a claude-code

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

GitHub CLI
$ gh skill install IgorWarzocha/Opencode-Workflows agent-architect --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/IgorWarzocha/Opencode-Workflows.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.opencode/skill/agent-architect .claude/skills/agent-architect && 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
agent-architect
GitHub stars
122
Token cost
~2.8k tokens
SKILL.md length
1,011 words
Files
3 (incl. references)
Skills in repo
35
Repo updated
First seen
Licence
None found

At a glance

Create and refine OpenCode agents via guided Q&A. An agent skill from IgorWarzocha/Opencode-Workflows.

  • Works in 5 steps: Core Purpose (Required) → 5: Research the Domain → Capabilities (Ask broadly, then drill… → …
  • Tasks that involve Code review
  • SKILL.md covers Agent Locations, Agent File Format, Agent Modes and Phase 1: Core Purpose (Required), plus 12 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Agent Architect is an agent skill from IgorWarzocha/Opencode-Workflows. Create and refine OpenCode agents via guided Q&A. Use proactively for agent creation, performance improvement, or configuration design. Examples: - user: "Create an agent for code reviews" → ask about scope, permissions, tools, model preferences, generate AGENTS.md frontmatter - user: "My agent ignores context" → analyze description clarity, allowed-tools, permissions, suggest improvements - user: "Add a database expert agent" → gather requirements, set convex-database-expert in subagenttype, configure…

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/agent-patterns.md` and `references/opencode-config.md`).

It sits in Agent Workflows, covering Code review and Subagents. It works with Convex. The repository describes itself as: An ever evolving repository of Opencode workflow examples that might enhance your experience with it. I only left the stuff that actually works. YMMV.

When your agent uses it

  • Tasks that involve Code review
  • Tasks that involve Subagents

Example prompts

  • “Create an agent for code reviews”
  • “My agent ignores context”
  • “Add a database expert agent”
  • “/agent-architect”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Core Purpose (Required)
  2. 5: Research the Domain
  3. Capabilities (Ask broadly, then drill down)
  4. Details (Optional—user MAY skip)
  5. Review & Refine

What it can do on your machine

Read from SKILL.md and the folder at commit 6444ec4. 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 yaml, markdown and xml).

    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

Agent Architect loads about 2.8k tokens when it runs, and up to ~5.1k if it reads all its reference files. Until then it costs about 159 tokens; SKILL.md has 1,011 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~159
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.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

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,011 words (~2,832 tokens).

“Create and refine opencode agents through a guided Q&A process.”

— opening of SKILL.md by IgorWarzocha
name
agent-architect

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (references) in .opencode/skill/agent-architect of IgorWarzocha/Opencode-Workflows.

  • SKILL.md
  • references/agent-patterns.md
  • references/opencode-config.md

Open the folder on GitHubat commit 6444ec4

Compare with similar skills

Agent Architect 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.

Agent Architect compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agent Architect this skillIgorWarzocha/Opencode-Workflows122—~2.8kAutomated safety check: PassNone
O2 Review Loopopenobserve/openobserve22k—~3.7kAutomated safety check: PassAGPL-3.0
Elvesaigorahub/elves222—~16kAutomated safety check: NotesMIT
Subagent-Driven DevelopmentHoangNguyen0403/agent-skills-standard571—~1.3kAutomated safety check: PassMIT
Reviewjuliepy/AI-Engineer-from-scrach433—~417Automated safety check: PassNone
Simplifytellahq/opensession392—~834Automated safety check: PassMIT

Similar skills

  • 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
  • Elves

    aigorahub/elves

    Autonomous multi-batch development agent for long unattended runs, reviewed-PR landing, Cobbler-first orchestration, and optional Fugu, Manus, Grok, Devin, or Oh My Pi (omp) provider shortcuts.

    222 GitHub stars~16k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check: notes
  • Subagent-Driven Development

    HoangNguyen0403/agent-skills-standard

    Runs a multi-task implementation plan by sending each task to a fresh implementer subagent, reviewing it independently, then reviewing the whole branch.

    571 GitHub stars~1.3k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Review

    juliepy/AI-Engineer-from-scrach

    Delegate the latest implementation diff to the code-reviewer sub-agent for a PASS/CONCERNS verdict against CLAUDE.md rules, then write the verdict to reports/<feature-review.md.

    433 GitHub stars~417 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Simplify

    tellahq/opensession

    Clean up the changed code without changing behavior — review the diff for reuse, simplification, efficiency, and altitude cleanups via 4 parallel agents, then apply the fixes

    392 GitHub stars~834 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Official

    Runs a loop on a GitHub pull request: fetch review state, triage comments into actions, implement them and resolve threads, repeating until nothing actionable is left.

    48k GitHub stars~2.2k tokensUpdated today
    DevelopmentAuto-check passed

More from IgorWarzocha/Opencode-Workflows

All 35 skills in this repo
  • Create Opencode Plugin

    IgorWarzocha/Opencode-Workflows

    Create OpenCode plugins using the @opencode-ai/plugin SDK. An agent skill from IgorWarzocha/Opencode-Workflows.

    122 GitHub stars~2.4k tokensUpdated 8 mo ago
    Auto-check passed
  • Plugin Installer

    IgorWarzocha/Opencode-Workflows

    Find, install, and configure OpenCode plugins from the catalog or community.

    122 GitHub stars~1.3k tokensUpdated 8 mo ago
    Auto-check passed
  • Skill Creator

    IgorWarzocha/Opencode-Workflows

    Guide for creating effective opencode skills. An agent skill from IgorWarzocha/Opencode-Workflows.

    122 GitHub stars~2.8k tokensUpdated 8 mo ago
    Auto-check passed
  • Security AI Keys

    IgorWarzocha/Opencode-Workflows

    Review AI API key leakage patterns and redaction strategies.

    122 GitHub stars~793 tokensUpdated 8 mo ago
    Auto-check: notes
  • Security Convex

    IgorWarzocha/Opencode-Workflows

    Review Convex security audit patterns for authentication and authorization.

    122 GitHub stars~3.1k tokensUpdated 8 mo ago
    Auto-check passed
  • Security Django

    IgorWarzocha/Opencode-Workflows

    Review Django security audit patterns for settings and middleware.

    122 GitHub stars~1.6k tokensUpdated 8 mo ago
    Auto-check: notes

Works with

Questions about Agent Architect

What does Agent Architect do?

Create and refine OpenCode agents via guided Q&A. An agent skill from IgorWarzocha/Opencode-Workflows. Agent Architect is an agent skill from IgorWarzocha/Opencode-Workflows. Create and refine OpenCode agents via guided Q&A.

When should I use Agent Architect?

Agent Architect fits situations like: tasks that involve Code review; tasks that involve Subagents.

How do I install Agent Architect in Claude Code?

Run `npx skills add IgorWarzocha/Opencode-Workflows --skill agent-architect -a claude-code`. Or copy the skill folder (.opencode/skill/agent-architect in IgorWarzocha/Opencode-Workflows) into .claude/skills/agent-architect in your project. Claude Code loads it when a task matches its description.

How do I install Agent Architect in Codex?

Run `npx skills add IgorWarzocha/Opencode-Workflows --skill agent-architect -a codex`. Or copy the skill folder (.opencode/skill/agent-architect in IgorWarzocha/Opencode-Workflows) into .agents/skills/agent-architect in your project. Codex loads it when a task matches its description.

Can I use Agent Architect 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 IgorWarzocha/Opencode-Workflows --skill agent-architect -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent-architect, .gemini/skills/agent-architect, .github/skills/agent-architect and .opencode/skills/agent-architect in your project.

What does Agent Architect need to run?

SKILL.md names no scripts, command-line tools or credentials: Agent Architect is instructions for the agent only.

Does Agent Architect 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 Agent Architect 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 Agent Architect use?

No licence was found for Agent Architect or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Agent Architect use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.3k tokens, read only when the agent opens those files.

What are the alternatives to Agent Architect?

Skills that share tags, products or a category with Agent Architect: O2 Review Loop (openobserve/openobserve, 22k stars), Elves (aigorahub/elves, 222 stars), Subagent-Driven Development (HoangNguyen0403/agent-skills-standard, 571 stars) and Review (juliepy/AI-Engineer-from-scrach, 433 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent Architect?

IgorWarzocha (a GitHub user) maintains it in IgorWarzocha/Opencode-Workflows, which has 122 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on February 4, 2026.

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