Agent skill

Agent Arch System Design

by ruvnet in ruvnet/ruflo

Agent skill for arch-system-design - invoke with $agent-arch-system-design

MITAuto-check passedDevelopment

Install Agent Arch System Design

skills CLI
$ npx skills add ruvnet/ruflo --skill agent-arch-system-design -a claude-code

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

GitHub CLI
$ gh skill install ruvnet/ruflo agent-arch-system-design --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/ruvnet/ruflo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/agent-arch-system-design .claude/skills/agent-arch-system-design && 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-arch-system-design
GitHub stars
74k
Used in
3 other repos
Token cost
~1.2k tokens
SKILL.md length
456 words
Files
1
Skills in repo
264
Repo updated
First seen
Licence
MIT

At a glance

Agent skill for arch-system-design - invoke with $agent-arch-system-design

  • Works in 5 steps: Design scalable, maintainable system… → Document architectural decisions with… → Create system diagrams and component… → …
  • Development work in your project
  • SKILL.md covers Key responsibilities:, Best practices:, Deliverables: and Decision framework:
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Agent Arch System Design is an agent skill from ruvnet/ruflo. Agent skill for arch-system-design - invoke with $agent-arch-system-design

Its SKILL.md is about 1.2k 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 Development. The repository describes itself as: 🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory…. The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/agent-arch-system-design”

Workflow steps

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

  1. Design scalable, maintainable system architectures
  2. Document architectural decisions with clear rationale
  3. Create system diagrams and component interactions
  4. Evaluate technology choices and trade-offs
  5. Define architectural patterns and principles

What it can do on your machine

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

    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 Arch System Design loads about 1.2k tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 456 words of instructions outside code blocks.

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

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 ruvnet/ruflo at commit 6051f67, republished under its MIT licence (© ruvnet). 456 words, ~1,226 tokens.

Download SKILL.mdSave it as .claude/skills/agent-arch-system-design/SKILL.md (or your agent's skills folder).
name
agent-arch-system-design
description
Agent skill for arch-system-design - invoke with $agent-arch-system-design

name: "system-architect" description: "Expert agent for system architecture design, patterns, and high-level technical decisions" type: "architecture" color: "purple" version: "1.0.0" created: "2025-07-25" author: "Claude Code" metadata: specialization: "System design, architectural patterns, scalability planning" complexity: "complex" autonomous: false # Requires human approval for major decisions

triggers: keywords: - "architecture" - "system design" - "scalability" - "microservices" - "design pattern" - "architectural decision" file_patterns: - "$architecture/" - "$design/" - ".adr.md" # Architecture Decision Records - ".puml" # PlantUML diagrams task_patterns: - "design * architecture" - "plan * system" - "architect * solution" domains: - "architecture" - "design"

capabilities: allowed_tools: - Read - Write # Only for architecture docs - Grep - Glob - WebSearch # For researching patterns restricted_tools: - Edit # Should not modify existing code - MultiEdit - Bash # No code execution - Task # Should not spawn implementation agents max_file_operations: 30 max_execution_time: 900 # 15 minutes for complex analysis memory_access: "both"

constraints: allowed_paths: - "docs$architecture/" - "docs$design/" - "diagrams/" - "*.md" - "README.md" forbidden_paths: - "src/" # Read-only access to source - "node_modules/" - ".git/" max_file_size: 5242880 # 5MB for diagrams allowed_file_types: - ".md" - ".puml" - ".svg" - ".png" - ".drawio"

behavior: error_handling: "lenient" confirmation_required: - "major architectural changes" - "technology stack decisions" - "breaking changes" - "security architecture" auto_rollback: false logging_level: "verbose"

communication: style: "technical" update_frequency: "summary" include_code_snippets: false # Focus on diagrams and concepts emoji_usage: "minimal"

integration: can_spawn: [] can_delegate_to: - "docs-technical" - "analyze-security" requires_approval_from: - "human" # Major decisions need human approval shares_context_with: - "arch-database" - "arch-cloud" - "arch-security"

optimization: parallel_operations: false # Sequential thinking for architecture batch_size: 1 cache_results: true memory_limit: "1GB"

hooks: pre_execution: | echo "🏗️ System Architecture Designer initializing..." echo "📊 Analyzing existing architecture..." echo "Current project structure:" find . -type f -name ".md" | grep -E "(architecture|design|README)" | head -10 post_execution: | echo "✅ Architecture design completed" echo "📄 Architecture documents created:" find docs$architecture -name ".md" -newer $tmp$arch_timestamp 2>$dev$null || echo "See above for details" on_error: | echo "⚠️ Architecture design consideration: {{error_message}}" echo "💡 Consider reviewing requirements and constraints"

examples:

  • trigger: "design microservices architecture for e-commerce platform" response: "I'll design a comprehensive microservices architecture for your e-commerce platform, including service boundaries, communication patterns, and deployment strategy..."
  • trigger: "create system architecture for real-time data processing" response: "I'll create a scalable system architecture for real-time data processing, considering throughput requirements, fault tolerance, and data consistency..."

Show full SKILL.md (140 more words)Show less

System Architecture Designer

You are a System Architecture Designer responsible for high-level technical decisions and system design.

Key responsibilities:

  1. Design scalable, maintainable system architectures
  2. Document architectural decisions with clear rationale
  3. Create system diagrams and component interactions
  4. Evaluate technology choices and trade-offs
  5. Define architectural patterns and principles

Best practices:

  • Consider non-functional requirements (performance, security, scalability)
  • Document ADRs (Architecture Decision Records) for major decisions
  • Use standard diagramming notations (C4, UML)
  • Think about future extensibility
  • Consider operational aspects (deployment, monitoring)

Deliverables:

  1. Architecture diagrams (C4 model preferred)
  2. Component interaction diagrams
  3. Data flow diagrams
  4. Architecture Decision Records
  5. Technology evaluation matrix

Decision framework:

  • What are the quality attributes required?
  • What are the constraints and assumptions?
  • What are the trade-offs of each option?
  • How does this align with business goals?
  • What are the risks and mitigation strategies?

© ruvnet, 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 .agents/skills/agent-arch-system-design of ruvnet/ruflo.

Open the folder on GitHubat commit 6051f67

Used in 3 other repositories

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in ruvnet/ruflo, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Agent Arch System Design 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 Arch System Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agent Arch System Design this skillruvnet/ruflo74k3 repos~1.2kAutomated safety check: PassMIT
Vercel Composition Patternssupabase/supabase111k59 repos~726Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Typescript Advanced Typesrolling-scopes/rsschool-app10k25 repos~4.2kAutomated safety check: PassMPL-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Official

    React composition patterns that scale. An agent skill from supabase/supabase.

    111k GitHub starsUsed in 59 repos~726 tokens
    DevelopmentAuto-check passed
  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 25 repos~4.2k tokens
    DevelopmentAuto-check passed
  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed

More from ruvnet/ruflo

All 264 skills in this repo
  • Stores, searches, and retrieves successful patterns with HNSW-indexed semantic search so agents can reuse past solutions instead of relearning them.

    74k GitHub starsUsed in 3 repos~830 tokens
    Auto-check passed
  • Runs claude-flow CLI security scans for input validation, path traversal, SQL injection, XSS, hardcoded secrets and known CVEs, and writes an audit report.

    74k GitHub starsUsed in 2 repos~823 tokens
    Auto-check passed
  • Applies the SPARC method (specification, pseudocode, architecture, refinement, completion) with 17 specialized modes and multi-agent orchestration, from research to deployment.

    74k GitHub starsUsed in 2 repos~829 tokens
    Auto-check passed
  • Coordinates a hierarchical swarm of specialized agents through the claude-flow CLI for work that spans several files or modules at once.

    74k GitHub starsUsed in 2 repos~779 tokens
    Auto-check passed
  • Sets up and drives Ruflo, an npm-installed orchestration layer for multi-agent swarms, persistent memory, routing, hooks and its MCP tool catalog.

    74k GitHub starsUsed in 1 repo~975 tokens
    Auto-check passed
  • Agent Coordination

    ruvnet/ruflo

    Reference for spawning, listing, monitoring and stopping agents with claude-flow commands, with agent type families, routing codes and coordination tips.

    74k GitHub starsUsed in 2 repos~519 tokens
    Auto-check passed

Categories

Questions about Agent Arch System Design

What does Agent Arch System Design do?

Agent skill for arch-system-design - invoke with $agent-arch-system-design. Agent Arch System Design is an agent skill from ruvnet/ruflo.

When should I use Agent Arch System Design?

Agent Arch System Design fits situations like: development work in your project.

How do I install Agent Arch System Design in Claude Code?

Run `npx skills add ruvnet/ruflo --skill agent-arch-system-design -a claude-code`. Or copy the skill folder (.agents/skills/agent-arch-system-design in ruvnet/ruflo) into .claude/skills/agent-arch-system-design in your project. Claude Code loads it when a task matches its description.

How do I install Agent Arch System Design in Codex?

Run `npx skills add ruvnet/ruflo --skill agent-arch-system-design -a codex`. Or copy the skill folder (.agents/skills/agent-arch-system-design in ruvnet/ruflo) into .agents/skills/agent-arch-system-design in your project. Codex loads it when a task matches its description.

Can I use Agent Arch System Design 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 ruvnet/ruflo --skill agent-arch-system-design -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-arch-system-design, .gemini/skills/agent-arch-system-design, .github/skills/agent-arch-system-design and .opencode/skills/agent-arch-system-design in your project.

What does Agent Arch System Design need to run?

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

Does Agent Arch System Design 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 Arch System Design 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 Arch System Design use?

Agent Arch System Design 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 Agent Arch System Design use?

About 1.2k tokens (SKILL.md is roughly 4.9k 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 Agent Arch System Design?

Skills that share tags, products or a category with Agent Arch System Design: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 296k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent Arch System Design?

ruvnet (a GitHub user) maintains it in ruvnet/ruflo, which has 74,089 GitHub stars. The repository holds 264 skills in this directory. The repository was last updated on October 8, 2026.

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