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

Workflow Architect

by magnus919 in magnus919/agent-skills

Discover your actual workflow through conversation or observation, then generate a tailored skills bundle that encodes it as loadable agent skills with trigger conditions.

MITAuto-check passed

Install Workflow Architect

skills CLI
$ npx skills add magnus919/agent-skills --skill workflow-architect -a claude-code

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

GitHub CLI
$ gh skill install magnus919/agent-skills workflow-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/magnus919/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/workflow-architect .claude/skills/workflow-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
workflow-architect
GitHub stars
116
Token cost
~1.9k tokens
SKILL.md length
918 words
Files
35 (incl. references)
Skills in repo
130
Repo updated
First seen
Licence
MIT

At a glance

Discover your actual workflow through conversation or observation, then generate a tailored skills bundle that encodes it as loadable agent skills with trigger conditions.

  • Works in 4 steps: Read this umbrella SKILL.md for context → If active: load… → If passive: load skills/observer/SKILL.md → …
  • You want to understand your own process
  • SKILL.md covers What You Get, Two Modes, Loading Protocol and What the Interview Builds, plus 4 more sections
  • Runs Shell scripts from its folder

What it does

Workflow Architect is an agent skill from magnus919/agent-skills. Discover your actual workflow through conversation or observation, then generate a tailored skills bundle that encodes it as loadable agent skills with trigger conditions. Use when you want to understand your own process, formalize it, or share it with collaborators. Also use when a session feels aimless — this skill gives it structure. Do not use this skill for unrelated requests; route to the nearest named specialist.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 40 other files, including reference files (for example `AGENTS.md`, `README.md` and `evals/evals.json`). Compatibility notes: Hermes Agent — uses skillview(), memory tool, session context scanning, and writefile for bundle generation. Output bundles are standard Agent Skills.

The repository describes itself as: Curated collection of AI agent skills for Hermes and other agent frameworks. The licence is MIT.

When your agent uses it

  • You want to understand your own process
  • Share it with collaborators
  • A session feels aimless — this skill gives it structure
  • Unrelated requests

Example prompts

  • “/workflow-architect”

Requirements

  • A Bash shell
  • Compatibility (from SKILL.md): Hermes Agent — uses skill_view(), memory tool, session context scanning, and write_file for bundle generation. Output bundles are standard Agent Skills.

Workflow steps

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

  1. Read this umbrella SKILL.md for context
  2. If active: load skills/interviewer/SKILL.md
  3. If passive: load skills/observer/SKILL.md
  4. After convergence: load skills/bundle-builder/SKILL.md to synthesize

What it can do on your machine

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

    Ships script files (Shell, from the files we listed), which the agent can run.

    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

    Hermes Agent — uses skill_view(), memory tool, session context scanning, and write_file for bundle generation. Output bundles are standard Agent Skills.

    From compatibility in the SKILL.md frontmatter.

Context cost

Workflow Architect loads about 1.9k tokens when it runs, and up to ~14k if it reads all its reference files. Until then it costs about 111 tokens; SKILL.md has 918 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~111
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~14k

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 magnus919/agent-skills at commit c545c2b, republished under its MIT licence (© magnus919). 918 words, ~1,936 tokens.

Download SKILL.mdSave it as .claude/skills/workflow-architect/SKILL.md (or your agent's skills folder). This skill also uses 34 other files; get the full folder from GitHub.
name
workflow-architect
description
Discover your actual workflow through conversation or observation, then generate a tailored skills bundle that encodes it as loadable agent skills with trigger conditions. Use when you want to understand your own process, formalize it, or share it with collaborators. Also use when a session feels aimless — this skill gives it structure. Do not use this skill for unrelated requests; route to the nearest named specialist.
compatibility
Hermes Agent — uses skill_view(), memory tool, session context scanning, and write_file for bundle generation. Output bundles are standard Agent Skills.
license
MIT
metadata.tags
workflow, meta, productivity, skills-bundle, onboarding, process
metadata.spec-version
1.0

Workflow Architect

A meta-skill that helps you (and your agent) understand how you actually work. It discovers your workflow patterns through either active interrogation or passive observation, then generates a skills bundle — a set of loadable skills, each with trigger conditions, that encode your workflow so your agent can meet you where you are in every session.

What You Get

After running workflow-architect, you'll have a new bundle in your agent's skill directory containing:

  • Umbrella SKILL.md — the entry point that makes the bundle auto-detectable via trigger conditions in its description. Load it with skill_view(name='<bundle-name>') or let the agent discover it automatically when you say something matching its triggers.
  • Sub-skills — one per phase of your workflow, each with a description that tells the agent when to load it (e.g., "load this when the user starts their morning triage routine" or "use this when the user shifts into deep work mode")
  • A manifest — maps skill names to their trigger conditions, entry points, and transition signals
  • A decision map — Mermaid flowchart visualizing your workflow as the agent sees it
  • A kanban board (optional) — only included if your workflow follows a predictable linear path where WIP limits and lane transitions add value

The umbrella and sub-skills are registered via skill_manage(action='create') so they appear in skills_list() and are immediately loadable in future sessions.

Two Modes

Workflow-architect adapts to how you want to engage with it.

Mode 1: Active Interrogation (One-Shot)

When to use: You have a few minutes to talk through your process. This is the most thorough mode — the agent asks guided questions, branches based on your answers, and builds a model of your workflow turn by turn.

How to invoke:

/workflow-architect

The agent will guide you through a conversation of about 8-15 questions. Answer naturally — the skill adapts its probes based on what you say.

Mode 2: Passive Observation

When to use: You're already in a session doing real work and don't want to stop and reflect. Let this mode watch what you actually do, then infer the workflow pattern from your actions.

How to invoke:

/workflow-architect passive

The agent loads the observer skill silently. It does nothing until you say one of the trigger phrases below, at which point it scans the current session's message history and reconstructs your workflow from what happened.

Trigger phrases (say any of these to activate observation analysis):

  • "catalog my workflow"
  • "what's my workflow"
  • "analyze my process"
  • "figure out what I do"
  • "work it out from what I just did"

Limitation: Observation mode works best after a session with at least 20+ turns of substantive work. If the session context is too thin, the observer will suggest switching to active interrogation mode instead.

Loading Protocol

  1. Read this umbrella SKILL.md for context
  2. If active: load skills/interviewer/SKILL.md
  3. If passive: load skills/observer/SKILL.md
  4. After convergence: load skills/bundle-builder/SKILL.md to synthesize and write the output bundle. The bundle is written to ~/.hermes/skills/<category>/<bundle-name>/ — verify the umbrella loads with skill_view(name='<bundle-name>') and at least one sub-skill loads with skill_view(name='<bundle-name>-<phase-name>'). Tell the user where it landed, what skills it contains, and a trigger phrase they can use to enter the workflow.
Show full SKILL.md (403 more words)Show less

What the Interview Builds

The interviewer (and observer, through inference) builds a structured model with these dimensions:

DimensionWhat it captures
Entry pointsHow your sessions typically start
PhasesThe distinct modes or stages in your workflow
Branching signalsWhat makes you go left vs right at each fork
Tool preferencesWhat you reach for in each phase
Loop conditionsWhat keeps you in a mode vs what kicks you out
Exit criteriaHow you know a session is done
Pain pointsWhat feels frictionful or inefficient

Environment

No environment variables required. State is stored via memory tool with the prefix workflow-architect:state: so it persists across turns during multi-turn interviews.

When not to use

Do not use this skill for one-off task help or when there is no repeatable multi-phase workflow worth capturing — a standalone skill is a better fit. If you already have a well-defined process and only need it packaged, generate the bundle directly rather than re-running an interview.

Prerequisites

This skill ships no scripts; it is a resource-based protocol carried by the files bundled with this SKILL.md:

  • Sub-skill protocols — skills/interviewer/SKILL.md (active interrogation), skills/observer/SKILL.md (passive observation), and skills/bundle-builder/SKILL.md (bundle synthesis and registration). Load them per the Loading Protocol above.
  • Reference patterns — references/workflow-archetypes.md (convergence-detection pattern library), references/trigger-condition-patterns.md (trigger-condition format spec), references/kanban-decision-criteria.md (when to include a kanban board), and references/example-output/ (worked example bundles: developer-triage, developer-pipeline-kanban).
  • Generation templates — templates/skill-skeleton.md, templates/manifest.yaml.tmpl, templates/decision-map.md.tmpl, templates/kanban-board-setup.sh.tmpl, and templates/kanban-task-blueprints.yaml.tmpl for the generated bundle's files.
  • Agent capabilities — the host agent needs skill management tools (skill_view, skill_manage, skills_list), a memory tool for workflow-architect:state: keys, session context access for observation mode, and file writing for bundle output.
  • A writable skills directory — generated bundles land in ~/.hermes/skills/<category>/<bundle-name>/; that location must be creatable and registrable.

Limitations

  • The output targets the Hermes-style skill runtime named in compatibility: bundles are standard Agent Skills, but registration via skill_manage(action='create') and the ~/.hermes/skills path assume that environment. On other runtimes, copy the bundle manually into the client's skill directory.
  • Passive observation reconstructs only what happened in the current session; with fewer than roughly 20 substantive turns it will under-infer and should fall back to active interrogation.
  • The generated workflow is only as good as what you say or do during discovery — phases, branching signals, and exit criteria are inferred from evidence, not invented, so thin input yields generic bundles.
  • Bundle generation writes new skill files and registers them; confirm scope before overwriting an existing bundle of the same name.

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

Files

SKILL.md and 34 other files (references) in workflow-architect of magnus919/agent-skills.

  • SKILL.md
  • AGENTS.md
  • README.md
  • evals/evals.json
  • manifest.yaml
  • references/example-output/developer-pipeline-kanban/README.md
  • references/example-output/developer-pipeline-kanban/decision-map.md
  • references/example-output/developer-pipeline-kanban/kanban/README.md
  • references/example-output/developer-pipeline-kanban/kanban/board-setup.sh
  • references/example-output/developer-pipeline-kanban/kanban/task-blueprints.yaml
  • references/example-output/developer-pipeline-kanban/manifest.yaml
  • references/example-output/developer-pipeline-kanban/skills/build.md
  • references/example-output/developer-pipeline-kanban/skills/deploy.md
  • references/example-output/developer-pipeline-kanban/skills/review.md
  • references/example-output/developer-triage
  • … and 20 more

Open the folder on GitHubat commit c545c2b

Compare with similar skills

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

Workflow Architect compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workflow Architect this skillmagnus919/agent-skills116—~1.9kAutomated safety check: PassMIT
Langsmith ObservabilityOrchestra-Research/AI-Research-SKILLs13k2 repos~2.4kAutomated safety check: PassMIT
ObservabilityBuilderIO/agent-native7.1k—~7.3kAutomated safety check: PassNone
Frontend Observabilitysickn33/agentic-awesome-skills47k1 repos~5.1kAutomated safety check: PassMIT
Ebpf Observabilitysickn33/agentic-awesome-skills47k2 repos~3.3kAutomated safety check: NotesMIT
Python Observabilitywshobson/agents40k—~1.8kAutomated safety check: PassMIT

Similar skills

  • Langsmith Observability

    Orchestra-Research/AI-Research-SKILLs

    LLM observability platform for tracing, evaluation, and monitoring.

    13k GitHub starsUsed in 2 repos~2.4k tokens
    AI & LLM EngineeringAuto-check passed

  • Observability

    BuilderIO/agent-native

    Agent observability, evals, feedback, and experiments. An agent skill from BuilderIO/agent-native.

    7.1k GitHub stars~7.3k tokensUpdated today
    DevOps & CloudAuto-check passed

  • Frontend Observability

    sickn33/agentic-awesome-skills

    A portable, framework-agnostic field-side observability system for any React or React Native app.

    47k GitHub starsUsed in 1 repo~5.1k tokens
    DevOps & CloudAuto-check passed

  • Ebpf Observability

    sickn33/agentic-awesome-skills

    Use eBPF for deep kernel-level observability — trace syscalls, network flows, and application behavior without code changes using Cilium, Tetragon, and bpftrace.

    47k GitHub starsUsed in 2 repos~3.3k tokens
    DevOps & CloudAuto-check: notes

  • Python Observability

    wshobson/agents

    Python observability patterns including structured logging, metrics, and distributed tracing.

    40k GitHub stars~1.8k tokensUpdated 4 days ago
    DevOps & CloudAuto-check passed

  • Observability Designer

    alirezarezvani/claude-skills

    Design production-ready observability strategies combining metrics, logs, and traces.

    28k GitHub stars~3.5k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed

More from magnus919/agent-skills

All 130 skills in this repo

  • Artifact Pyramids

    magnus919/agent-skills

    Organize durable agent research outputs as summaries, analysis, and evidence dossiers.

    116 GitHub stars~2.7k tokensUpdated yesterday
    Auto-check passed

  • Ascii City Engine

    magnus919/agent-skills

    Build portable, first-person colored ASCII city engines and small GIS-derived city packs.

    116 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed

  • Color Management

    magnus919/agent-skills

    Manage color workflows with ICC profiles, working spaces, gamut mapping, and color science.

    116 GitHub stars~2.6k tokensUpdated yesterday
    Auto-check: notes

  • Data Scientist

    magnus919/agent-skills

    A skill your agent uses for PhD-level expertise in data science, statistics, and machine learning: rigorous statistical analysis, experimental design, causal inference, advanced modeling, research…

    116 GitHub stars~4.1k tokensUpdated yesterday
    Auto-check passed

  • Docker Compose

    magnus919/agent-skills

    Use Docker Compose to define, run, debug, and harden multi-container applications.

    116 GitHub stars~2k tokensUpdated yesterday
    Auto-check: notes

  • Fpga Development

    magnus919/agent-skills

    Design, review, simulate, and verify FPGA logic using explicit RTL contracts, clock and reset models, CDC analysis, timing constraints, and reproducible implementation evidence.

    116 GitHub stars~2.7k tokensUpdated yesterday
    Auto-check passed

Questions about Workflow Architect

What does Workflow Architect do?

Discover your actual workflow through conversation or observation, then generate a tailored skills bundle that encodes it as loadable agent skills with trigger conditions. Workflow Architect is an agent skill from magnus919/agent-skills. Discover your actual workflow through conversation or observation, then generate a tailored skills bundle that encodes it as loadable agent skills with trigger conditions.

When should I use Workflow Architect?

Workflow Architect fits situations like: you want to understand your own process; share it with collaborators; A session feels aimless — this skill gives it structure; unrelated requests.

How do I install Workflow Architect in Claude Code?

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

How do I install Workflow Architect in Codex?

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

Can I use Workflow 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 magnus919/agent-skills --skill workflow-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/workflow-architect, .gemini/skills/workflow-architect, .github/skills/workflow-architect and .opencode/skills/workflow-architect in your project.

What does Workflow Architect need to run?

Going by SKILL.md and its folder, Workflow Architect needs a shell for the scripts in its folder. Our summary lists: A Bash shell. Compatibility (from SKILL.md): Hermes Agent — uses skill_view(), memory tool, session context scanning, and write_file for bundle generation. Output bundles are standard Agent Skills..

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

Workflow Architect is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Workflow Architect use?

About 1.9k tokens (SKILL.md is roughly 7.7k 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 12k tokens, read only when the agent opens those files.

What are the alternatives to Workflow Architect?

Skills that share tags, products or a category with Workflow Architect: Langsmith Observability (Orchestra-Research/AI-Research-SKILLs, 13k stars), Observability (BuilderIO/agent-native, 7.1k stars), Frontend Observability (sickn33/agentic-awesome-skills, 47k stars) and Ebpf Observability (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workflow Architect?

magnus919 (a GitHub user) maintains it in magnus919/agent-skills, which has 116 GitHub stars. The repository holds 130 skills in this directory. The repository was last updated on October 8, 2026.

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