Agent skill

Working With Architects

by manager-dot-dev in manager-dot-dev/manager-skills

Helps engineering managers work effectively with Software Architects, Staff Engineers, and Principal Engineers — covers the EM's side of the relationship (responsiveness, proactive consultation…

MITAuto-check passedMedia & Creative

Install Working With Architects

skills CLI
$ npx skills add manager-dot-dev/manager-skills --skill working-with-architects -a claude-code

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

GitHub CLI
$ gh skill install manager-dot-dev/manager-skills working-with-architects --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/manager-dot-dev/manager-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/working-with-architects .claude/skills/working-with-architects && 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
working-with-architects
GitHub stars
114
Token cost
~1.8k tokens
SKILL.md length
942 words
Files
2 (incl. references)
Skills in repo
27
Repo updated
First seen
Licence
MIT

At a glance

Helps engineering managers work effectively with Software Architects, Staff Engineers, and Principal Engineers — covers the EM's side of the relationship (responsiveness, proactive consultation…

  • Works in 5 steps: Situation: advice, review, decision,… → EM responsibility: what the manager must… → Architect ask: specific input, decision,… → …
  • The user says architect
  • SKILL.md covers Before Starting, Response Style, How to Use This Skill and Default Response Shape, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Working With Architects is an agent skill from manager-dot-dev/manager-skills. Helps engineering managers work effectively with Software Architects, Staff Engineers, and Principal Engineers — covers the EM's side of the relationship (responsiveness, proactive consultation, giving credit), how to advocate for architect time, pre-consultation preparation, and the two architecture team models (Centralized vs. Decentralized). Use when the user says "architect," "staff engineer," "principal engineer," "technical design review," "working with senior technical people," "getting architecture help,"…

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/sources.md`).

It sits in Media & Creative, covering Design review and critique. The repository describes itself as: Skills for engineering managers. The licence is MIT.

When your agent uses it

  • The user says architect
  • Principal engineer
  • Technical design review
  • Working with senior technical people

Example prompts

  • “architect,”
  • “staff engineer,”
  • “principal engineer,”
  • “/working-with-architects”

Workflow steps

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

  1. Situation: advice, review, decision, blocked project, or architect-time request.
  2. EM responsibility: what the manager must own before asking for help.
  3. Architect ask: specific input, decision, review, or escalation needed.
  4. Preparation: context, constraints, options, and decision deadline.
  5. Relationship move: credit, follow-through, or expectation reset.

What it can do on your machine

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

Working With Architects loads about 1.8k tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 177 tokens; SKILL.md has 942 words of instructions outside code blocks.

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

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 manager-dot-dev/manager-skills at commit c47ebc7, republished under its MIT licence (© manager-dot-dev). 942 words, ~1,788 tokens.

Download SKILL.mdSave it as .claude/skills/working-with-architects/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
working-with-architects
description
Helps engineering managers work effectively with Software Architects, Staff Engineers, and Principal Engineers — covers the EM's side of the relationship (responsiveness, proactive consultation, giving credit), how to advocate for architect time, pre-consultation preparation, and the two architecture team models (Centralized vs. Decentralized). Use when the user says "architect," "staff engineer," "principal engineer," "technical design review," "working with senior technical people," "getting architecture help," or "how do I get more architect time." Do NOT use for managing staff/principal engineers who report directly to you (use `managing-high-performers` or `delegation`).
metadata.version
2.1.2

Working With Architects

Before Starting

Check for EM context first. If .agents/em-context.md exists, read it.

If .agents/em-context.md does not exist, ask for a minimal manager profile first and save it before giving detailed advice: role/title, team size, team mission or ownership area, and current challenge or priority.

If a specific person is central to the conversation and .agents/reports/[name].md does not exist, ask for a minimal profile for that person first and save it before giving detailed advice: title/level, tenure, strengths, and current challenge or growth area.

If the conversation reveals durable new context later, update .agents/em-context.md or .agents/reports/[name].md automatically. Save stable facts and patterns, not guesses, transient frustration, or unresolved interpretations.

Response Style

Keep the first answer concise and useful. Do not dump the whole framework unless the user asks for depth.

Default to:

  • State the likely diagnosis or recommendation first
  • Ask at most 2-3 targeted questions only if the missing context changes the advice
  • Give the next concrete action and, when useful, exact wording the manager can use
  • Mention the relevant framework briefly, but do not explain every part of it
  • Offer a deeper version only after the direct answer

How to Use This Skill

  • Unclear what the EM's responsibilities are in the architect relationship → Do Your Side Well
  • Need to make the case for architect time on a project → Their Side of the Deal — Don't Hesitate to Push
  • About to kick off a complex project with architect involvement → Before You Consult Them
  • Unclear who makes decisions — your team vs. the architecture function → Two Architecture Team Models

Applies to any cross-team Senior+ engineers — Architects, Staff Engineers, Principal Engineers. The title varies by organization.


Default Response Shape

When helping with architects or senior technical partners, clarify ownership:

  1. Situation: advice, review, decision, blocked project, or architect-time request.
  2. EM responsibility: what the manager must own before asking for help.
  3. Architect ask: specific input, decision, review, or escalation needed.
  4. Preparation: context, constraints, options, and decision deadline.
  5. Relationship move: credit, follow-through, or expectation reset.

Do not frame the architect as the owner of the EM's project unless they explicitly own delivery.


Do Your Side Well

Don't drag their requests

When Architects need something from you — security updates, a shared-service refactor, a new testing methodology — do it fast. These things are almost never truly urgent, which makes it tempting to take your time. Don't.

A big side benefit: being the first team to implement such initiatives gets you more help and guidance from the architects. They'll invest more in teams that move quickly on shared work.

Proactively consult them

For complex technical dilemmas, ask for their opinion before you decide — even on things smaller than what typically requires their involvement. When they're kept in the loop early, there's a much higher chance they can help in later stages.

Give credit

Long projects are easy to finish while forgetting the early help that made them possible. By the end, we often don't remember the significant guidance we got from architects in the initial phases.

When presenting a feature: mention their help, thank them personally. If they did exceptional work — let their manager know.


Their Side of the Deal

You own it — don't forget that

In complex projects, architects may write initial infrastructure or examples to show the way. Once that initial phase is done, the ownership is 100% yours. Their role is to help you do it in the best way — not to share responsibility when things go wrong.

Resist the temptation to offload incidents or mistakes onto work they contributed to. It's your project.

Show full SKILL.md (348 more words)Show less
Don't hesitate to push for their time

Architect time is never automatically allocated to your team. Those who advocate clearly are the ones who get help.

When asking for their involvement:

  • Define the scope of help you need
  • Explain why you need it and what benefit it provides to the organization (time-sensitive project, new technology useful to other teams, sensitive area of the codebase where mistakes are costly)
  • Argue your case

More senior team leaders get more resources because they present their cases better. Practice makes perfect.

Don't offload trivial things

Once you know exactly what to do and how to do it, you don't need them anymore. Let them move to the next important project. Abusing the privilege damages the relationship and wastes time that should go to harder problems.


Before You Consult Them

Collect context first. The first things any architect will ask when starting architecture work:

  • What do you know about the problem?
  • Why does the business need it solved?
  • When does it need to be solved?

Come prepared with these three answers.


Two Architecture Team Models

Centralized: Architects make all architecture decisions. You're the Subject Matter Expert — they consult you to understand the problem space, then design the solution. Requires tight, ongoing communication between you and the architect.

Decentralized: Architects help you design solutions for your team. They define principles and a Tech Radar. As long as you follow the guidelines, decision-making is yours. Communication is lighter, but you need to drive things forward and reach out proactively.

In either model: engage early. Engaging too late is the biggest mistake. If too much work has already been done, changing direction may require significant rework or be impossible.


Dive Deeper

If the user asks where a framework came from or wants more context on any topic in this skill — read references/sources.md.


  • delegation — Working with architects is one of the highest-leverage forms of external collaboration
  • influence — Arguing your case for architect time uses the same skills as broader stakeholder influence
  • managing-high-performers — If the architect reports to you, that's a different relationship with different dynamics

© manager-dot-dev, 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 1 other file (references) in skills/working-with-architects of manager-dot-dev/manager-skills.

  • SKILL.md
  • references/sources.md

Open the folder on GitHubat commit c47ebc7

Compare with similar skills

Working With Architects 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.

Working With Architects compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Working With Architects this skillmanager-dot-dev/manager-skills114—~1.8kAutomated safety check: PassMIT
Consult ClaudeEpicenterHQ/epicenter4.8k—~2kAutomated safety check: PassCustom licence
System Atlasinkboard/system-atlas429—~2.3kAutomated safety check: PassMIT
Design Image Studiokangarooking/design-image-studio102—~1.5kAutomated safety check: PassMIT
Kicad Reviewmixelpixx/Konnect905—~3.2kAutomated safety check: PassAGPL-3.0
Reimagine It AuditKayforkind/reimagine-it2031 repos~756Automated safety check: PassMIT

Similar skills

  • Consult Claude

    EpicenterHQ/epicenter

    Assign Claude Code a read-only investigation, recommendation, or finished text draft.

    4.8k GitHub stars~2k tokensUpdated today
    Media & CreativeAuto-check passed
  • System Atlas

    inkboard/system-atlas

    Build and maintain an explorable, progressively-disclosed isometric "atlas" of a system's architecture — an interactive page (hover to read, click to pin, go inside for steps, moving data packets…

    429 GitHub stars~2.3k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Design Image Studio

    kangarooking/design-image-studio

    Directly generate design-oriented AI images with strong creative direction and prompt engineering.

    102 GitHub stars~1.5k tokensUpdated 5 mo ago
    Media & CreativeAuto-check passed
  • Kicad Review

    mixelpixx/Konnect

    Design review and validation workflow for KiCAD projects via MCP tools.

    905 GitHub stars~3.2k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Reimagine It Audit

    Kayforkind/reimagine-it

    Design Health — runs 19 deterministic quality checks on HTML output.

    203 GitHub starsUsed in 1 repo~756 tokens
    Media & CreativeAuto-check passed
  • Design Audit

    UniClipboard/UniClipboard

    定期审计代码库的工程设计问题(高心智复杂度、单一真相源被破坏、catch-all 胖接口、死代码、散落魔法字面量、泄漏抽象、资源生命周期靠环形缓冲)与可优化点,范围限定为自上次审计以来的 git churn,每条发现都落到 file:line 并对照本项目自己的 VISION.md / 各级 AGENTS.md / memory…

    1.9k GitHub stars~554 tokensUpdated today
    Media & CreativeAuto-check passed

More from manager-dot-dev/manager-skills

All 27 skills in this repo
  • Em Grid Scorer

    manager-dot-dev/manager-skills

    Score an Engineering Manager's coverage across all 12 cells of the EM Grid based on their calendar and Slack.

    114 GitHub stars~5.8k tokensUpdated 5 mo ago
    Auto-check passed
  • Em Context

    manager-dot-dev/manager-skills

    Foundation skill for engineering managers. An agent skill from manager-dot-dev/manager-skills.

    114 GitHub stars~1.6k tokensUpdated 5 mo ago
    Auto-check passed
  • 1on1s

    manager-dot-dev/manager-skills

    Prepares agendas, diagnoses struggling 1:1 relationships, and gives frameworks for running effective 1:1 meetings with direct reports.

    114 GitHub stars~3k tokensUpdated 5 mo ago
    Auto-check passed
  • Business Literacy

    manager-dot-dev/manager-skills

    Explains business financial terms and frameworks for engineering managers — produces term definitions (ARR, COGS, CAC, LTV, gross margin, burn rate, EBITDA, AARRR), translation formulas for making…

    114 GitHub stars~2.4k tokensUpdated 5 mo ago
    Auto-check passed
  • Career Development

    manager-dot-dev/manager-skills

    Helps engineering managers support direct report growth — produces a stage-by-stage model of engineering impact (Circles of Influence), a framework for non-linear career planning (Tarzan Method)…

    114 GitHub stars~2.3k tokensUpdated 5 mo ago
    Auto-check passed
  • Delegation

    manager-dot-dev/manager-skills

    Guides managers out of the bottleneck role — provides the Team Rep pattern, Epic Ownership model, Task-Relevant Maturity framework, kingdom ownership, and three-layer assignment strategy.

    114 GitHub stars~3.3k tokensUpdated 5 mo ago
    Auto-check passed

Questions about Working With Architects

What does Working With Architects do?

Helps engineering managers work effectively with Software Architects, Staff Engineers, and Principal Engineers — covers the EM's side of the relationship (responsiveness, proactive consultation…. Working With Architects is an agent skill from manager-dot-dev/manager-skills. Helps engineering managers work effectively with Software Architects, Staff Engineers, and Principal Engineers — covers the EM's side of the relationship (responsiveness, proactive consultation, giving credit), how to advocate for architect time, pre-consultation preparation, and the two architecture team models (Centralized vs.

When should I use Working With Architects?

Working With Architects fits situations like: the user says architect; principal engineer; technical design review; working with senior technical people.

How do I install Working With Architects in Claude Code?

Run `npx skills add manager-dot-dev/manager-skills --skill working-with-architects -a claude-code`. Or copy the skill folder (skills/working-with-architects in manager-dot-dev/manager-skills) into .claude/skills/working-with-architects in your project. Claude Code loads it when a task matches its description.

How do I install Working With Architects in Codex?

Run `npx skills add manager-dot-dev/manager-skills --skill working-with-architects -a codex`. Or copy the skill folder (skills/working-with-architects in manager-dot-dev/manager-skills) into .agents/skills/working-with-architects in your project. Codex loads it when a task matches its description.

Can I use Working With Architects 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 manager-dot-dev/manager-skills --skill working-with-architects -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/working-with-architects, .gemini/skills/working-with-architects, .github/skills/working-with-architects and .opencode/skills/working-with-architects in your project.

What does Working With Architects need to run?

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

Does Working With Architects 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 Working With Architects 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 Working With Architects use?

Working With Architects 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 Working With Architects use?

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

What are the alternatives to Working With Architects?

Skills that share tags, products or a category with Working With Architects: Consult Claude (EpicenterHQ/epicenter, 4.8k stars), System Atlas (inkboard/system-atlas, 429 stars), Design Image Studio (kangarooking/design-image-studio, 102 stars) and Kicad Review (mixelpixx/Konnect, 905 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Working With Architects?

manager-dot-dev (a GitHub organization) maintains it in manager-dot-dev/manager-skills, which has 114 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on May 9, 2026.

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