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

Architecture

by nteract in nteract/nteract

Architecture and documentation framing for cross-cutting repo decisions, docs taxonomy placement, ADRs, memos, PRDs, implementation plans, audits, measurements, runbooks, and source-grounded…

BSD-3-ClauseAuto-check passedDevOps & Cloud

Install Architecture

skills CLI
$ npx skills add nteract/nteract --skill architecture -a claude-code

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

GitHub CLI
$ gh skill install nteract/nteract architecture --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/nteract/nteract.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/architecture .claude/skills/architecture && 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
architecture
GitHub stars
179
Token cost
~497 tokens
SKILL.md length
192 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
BSD-3-Clause

At a glance

Architecture and documentation framing for cross-cutting repo decisions, docs taxonomy placement, ADRs, memos, PRDs, implementation plans, audits, measurements, runbooks, and source-grounded…

  • Works in 4 steps: Read docs/README.md before creating or… → When moving docs, update indexes and… → Prefer the smallest durable artifact.… → …
  • Deciding where durable docs belong
  • SKILL.md covers Default Path, Placement and Workflow
  • Calls git and cargo

What it does

Architecture is an agent skill from nteract/nteract. Architecture and documentation framing for cross-cutting repo decisions, docs taxonomy placement, ADRs, memos, PRDs, implementation plans, audits, measurements, runbooks, and source-grounded proposals. Use when deciding where durable docs belong, drafting or moving architecture/product/design docs, or promoting .context/ notes into repo docs. Do not use for routine code changes unless they require durable cross-functional documentation.

Its SKILL.md is about 500 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 DevOps & Cloud, covering Architecture decision records, Runbooks and postmortems and Proposals and quotes. The repository describes itself as: We're back! Now firing notebooks out of a t-shirt gun. The licence is BSD-3-Clause.

When your agent uses it

  • Deciding where durable docs belong
  • Moving architecture/product/design docs
  • Promoting .context/ notes into repo docs
  • Routine code changes unless they require durable cross-functional documentation

Example prompts

  • “/architecture”

Workflow steps

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

  1. Read docs/README.md before creating or moving durable docs.
  2. When moving docs, update indexes and cross-links; search for old paths with
  3. Prefer the smallest durable artifact. Mark contentious sections as open
  4. Run focused link/path checks for moved docs and cargo xtask lint --fix

What it can do on your machine

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

    • git
    • cargo

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Architecture loads about 497 tokens when it runs. Until then it costs about 114 tokens; SKILL.md has 192 words of instructions outside code blocks.

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

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 nteract/nteract at commit 414222e, republished under its BSD-3-Clause licence (© nteract). 192 words, ~497 tokens.

Download SKILL.mdSave it as .claude/skills/architecture/SKILL.md (or your agent's skills folder).
name
architecture
description
Architecture and documentation framing for cross-cutting repo decisions, docs taxonomy placement, ADRs, memos, PRDs, implementation plans, audits, measurements, runbooks, and source-grounded proposals. Use when deciding where durable docs belong, drafting or moving architecture/product/design docs, or promoting `.context/` notes into repo docs. Do not use for routine code changes unless they require durable cross-functional documentation.

Architecture and Documentation

Use this skill when the work is about durable architecture, product, or design documentation, or when deciding where a document belongs. Do not load it for routine implementation notes, test plans, or ordinary code changes.

Default Path

  • Start working notes in .context/.
  • Keep routine implementation notes in the PR body, code comments, or final response.
  • Promote only when the artifact should outlive the immediate change and help product, design, engineering, research, or AI collaborators.

Placement

  • docs/memos/: shared thinking, research, options, and RFC-style proposals before there is a decision.
  • docs/adr/: durable technical decisions, invariants, compatibility boundaries, and rejected alternatives.
  • docs/prd/: user-facing requirements, workflows, roles, and launch criteria.
  • docs/plans/: scoped execution plans for already-framed work.
  • docs/audits/: source-backed evidence and follow-up lists.
  • docs/measurements/: benchmark evidence and performance models.
  • docs/runbooks/: operational procedures.

Workflow

  1. Read docs/README.md before creating or moving durable docs.
  2. When moving docs, update indexes and cross-links; search for old paths with git grep.
  3. Prefer the smallest durable artifact. Mark contentious sections as open questions or commentary instead of forcing them into a decision.
  4. Run focused link/path checks for moved docs and cargo xtask lint --fix before commit.

© nteract, BSD-3-Clause. 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/architecture of nteract/nteract.

Open the folder on GitHubat commit 414222e

Compare with similar skills

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

Architecture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Architecture this skillnteract/nteract179—~497Automated safety check: PassBSD-3-Clause
Frame A Proposalinkeep/open-knowledge4.4k—~3.6kAutomated safety check: PassGPL-3.0
Review A Designinkeep/open-knowledge4.4k—~3.7kAutomated safety check: PassGPL-3.0
Gh Doc Authorcaarlos0/dotfiles220—~2.2kAutomated safety check: PassMIT
Obsidian WriterAtmosphere/atmosphere3.8k—~2.6kAutomated safety check: PassApache-2.0
Foreman Grill DocsVisionForge-OU/foreman443—~1.6kAutomated safety check: PassCustom licence

Similar skills

  • Frame A Proposal

    inkeep/open-knowledge

    Frame a new design proposal (RFC-shape) under proposals/ — problem before solution, named beneficiary and observable change, real alternatives, honest drawbacks, and a live open-questions backlog.

    4.4k GitHub stars~3.6k tokensUpdated today
    Sales & SupportAuto-check passed

  • Review A Design

    inkeep/open-knowledge

    Reviews whether a design is SOUND — solving the right problem, derived from its stated goals and constraints — and emits ranked, evidence-backed findings, not edits.

    4.4k GitHub stars~3.7k tokensUpdated today
    DevOps & CloudAuto-check passed

  • Gh Doc Author

    caarlos0/dotfiles

    Author and revise clear GitHub internal documentation, including design docs, proposals, decision records, runbooks, status updates, and handoffs.

    220 GitHub stars~2.2k tokensUpdated today
    DevOps & CloudAuto-check passed

  • Obsidian Writer

    Atmosphere/atmosphere

    Write well-formatted notes to the atmosphere-vault Obsidian knowledge base.

    3.8k GitHub stars~2.6k tokensUpdated yesterday
    DevOps & CloudAuto-check passed

  • Foreman Grill Docs

    VisionForge-OU/foreman

    Headless grilling pass that challenges an approved implementation plan against the existing codebase and domain model, then writes an ADR draft and a PRD draft into the Foreman feature directory.

    443 GitHub stars~1.6k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed

  • Foreman Plan

    VisionForge-OU/foreman

    Headless implementation-plan authoring for the Foreman planning stage.

    443 GitHub stars~1k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed

More from nteract/nteract

All 10 skills in this repo

  • Automerge Sync

    nteract/nteract

    Automerge sync protocol internals, document model (OpSet, ChangeGraph, fork/merge, save/load lifecycle), and higher-level protocol design patterns.

    179 GitHub stars~4.5k tokensUpdated today
    Auto-check passed

  • Daemon Dev

    nteract/nteract

    Develop, debug, and manage the runtimed daemon, Python bindings, and build system.

    179 GitHub stars~3k tokensUpdated today
    Auto-check passed

  • Execution Pipeline

    nteract/nteract

    The end-to-end cell execution pipeline from MCP tool call through daemon to kernel and back.

    179 GitHub stars~2.7k tokensUpdated today
    Auto-check passed

  • Nteract Diagnostics

    nteract/nteract

    Pull and triage submitted nteract diagnostics archives from Cloudflare using a diagnostics id/token.

    179 GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Repl

    nteract/nteract

    Use nteract notebooks as a persistent Python REPL. An agent skill from nteract/nteract.

    179 GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Testing

    nteract/nteract

    Run tests, verify changes, and collect diagnostics. An agent skill from nteract/nteract.

    179 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

Categories

Questions about Architecture

What does Architecture do?

Architecture and documentation framing for cross-cutting repo decisions, docs taxonomy placement, ADRs, memos, PRDs, implementation plans, audits, measurements, runbooks, and source-grounded…. Architecture is an agent skill from nteract/nteract. Architecture and documentation framing for cross-cutting repo decisions, docs taxonomy placement, ADRs, memos, PRDs, implementation plans, audits, measurements, runbooks, and source-grounded proposals.

When should I use Architecture?

Architecture fits situations like: deciding where durable docs belong; moving architecture/product/design docs; promoting .context/ notes into repo docs; routine code changes unless they require durable cross-functional documentation.

How do I install Architecture in Claude Code?

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

How do I install Architecture in Codex?

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

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

What does Architecture need to run?

Going by SKILL.md and its folder, Architecture needs the command-line tools its instructions call (git and cargo).

Does Architecture access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Architecture 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 Architecture use?

Architecture is published under the BSD-3-Clause licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Architecture use?

About 497 tokens (SKILL.md is roughly 2k 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 Architecture?

Skills that share tags, products or a category with Architecture: Frame A Proposal (inkeep/open-knowledge, 4.4k stars), Review A Design (inkeep/open-knowledge, 4.4k stars), Gh Doc Author (caarlos0/dotfiles, 220 stars) and Obsidian Writer (Atmosphere/atmosphere, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Architecture?

nteract (a GitHub organization) maintains it in nteract/nteract, which has 179 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 7, 2026.

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