Agent skill

Repo Architecture

by inbrainfun in inbrainfun/inbrain

Where new brain files go. An agent skill from inbrainfun/inbrain.

Custom licenceAuto-check passedAgent Workflows

Install Repo Architecture

skills CLI
$ npx skills add inbrainfun/inbrain --skill repo-architecture -a claude-code

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

GitHub CLI
$ gh skill install inbrainfun/inbrain repo-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/inbrainfun/inbrain.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/repo-architecture .claude/skills/repo-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
repo-architecture
GitHub stars
142
Used in
1 other repo
Token cost
~403 tokens
SKILL.md length
150 words
Files
1
Skills in repo
52
Repo updated
First seen
Licence
Custom licence

At a glance

Where new brain files go. An agent skill from inbrainfun/inbrain.

  • Works in 4 steps: Identify the primary subject. What would… → Walk the decision tree → Cross-link. Link from related directories. → …
  • Tasks that involve Skill authoring
  • SKILL.md covers Contract, Phases, Output Format and Anti-Patterns
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Repo Architecture is an agent skill from inbrainfun/inbrain. Where new brain files go. Decision protocol for filing brain pages by primary subject, not by format or source. Reference for all brain-writing skills.

Its SKILL.md is about 400 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 Agent Workflows, covering Skill authoring.

When your agent uses it

  • Tasks that involve Skill authoring

Example prompts

  • “/repo-architecture”

Workflow steps

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

  1. Identify the primary subject. What would you search for to find this page?
  2. Walk the decision tree
  3. Cross-link. Link from related directories.
  4. Check notability. See skills/conventions/quality.md notability gate.

What it can do on your machine

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

Repo Architecture loads about 403 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 150 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 150 words (~403 tokens).

name
repo-architecture
version
1.0.0
triggers
where does this go, filing rules, create new page, which directory
tools
search, get_page, list_pages
mutating
false

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/repo-architecture of inbrainfun/inbrain.

Open the folder on GitHubat commit 5231990

Used in 1 other repository

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

Compare with similar skills

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

Repo Architecture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Repo Architecture this skillinbrainfun/inbrain1421 repos~403Automated safety check: PassCustom licence
Skill CreatorAzure/azqr79689 repos~8.2kAutomated safety check: PassApache-2.0
Claude Code Skill Developer Guidediet103/claude-code-infrastructure-showcase10k11 repos~3.5kAutomated safety check: PassMIT
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
Claude Code Command Developmentanthropics/claude-plugins-official38k10 repos~4.8kAutomated safety check: PassApache-2.0
Claude Code Plugin Structureanthropics/claude-plugins-official38k10 repos~3.4kAutomated safety check: PassApache-2.0

Similar skills

  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    796 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Skill Developer Guide

    diet103/claude-code-infrastructure-showcase

    A guide to creating and managing Claude Code skills with auto-activation: skill-rules.json triggers, hooks, enforcement levels, YAML frontmatter and progressive disclosure.

    10k GitHub starsUsed in 11 repos~3.5k tokens
    Agent WorkflowsAuto-check passed
  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Command Development

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code slash commands: Markdown files with YAML frontmatter, arguments, file references, bash context and interactive prompts.

    38k GitHub starsUsed in 10 repos~4.8k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Plugin Structure

    anthropics/claude-plugins-official

    Official

    Explains the directory layout, plugin.json manifest and component organization of a Claude Code plugin, including auto-discovery and portable paths.

    38k GitHub starsUsed in 10 repos~3.4k tokens
    Agent WorkflowsAuto-check passed
  • Skill Release Gate

    rohitg00/ai-engineering-from-scratch

    Evaluates an Agent Skill bundle before release for structure, trigger quality, artifact improvement, script correctness, safety, installed-tree integrity and host portability.

    66k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from inbrainfun/inbrain

All 52 skills in this repo
  • Academic Verify

    inbrainfun/inbrain

    Verify a research claim or academic citation by tracing it through publication → methodology → raw data → independent replication.

    142 GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Cold Start

    inbrainfun/inbrain

    Day-one data bootstrapping for a new brain. An agent skill from inbrainfun/inbrain.

    142 GitHub starsUsed in 1 repo~4.7k tokens
    Auto-check passed
  • Enrich

    inbrainfun/inbrain

    Enrich brain pages with tiered enrichment protocol. An agent skill from inbrainfun/inbrain.

    142 GitHub starsUsed in 1 repo~2.8k tokens
    Auto-check passed
  • Idea Lineage

    inbrainfun/inbrain

    Trace one idea's evolution through the brain: first mention, best articulation, related concepts, reversals, contradictions, abandoned branches, and the current live version.

    142 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed
  • Maintain

    inbrainfun/inbrain

    Brain health checks: back-link enforcement, citation audit, filing validation, stale info detection, orphan pages, and benchmarks.

    142 GitHub starsUsed in 1 repo~4.4k tokens
    Auto-check passed
  • Schema Author

    inbrainfun/inbrain

    Evolve your brain's schema pack. An agent skill from inbrainfun/inbrain.

    142 GitHub starsUsed in 1 repo~3.3k tokens
    Auto-check passed

Categories

Questions about Repo Architecture

What does Repo Architecture do?

Where new brain files go. An agent skill from inbrainfun/inbrain. Repo Architecture is an agent skill from inbrainfun/inbrain. Where new brain files go.

When should I use Repo Architecture?

Repo Architecture fits situations like: tasks that involve Skill authoring.

How do I install Repo Architecture in Claude Code?

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

How do I install Repo Architecture in Codex?

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

Can I use Repo 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 inbrainfun/inbrain --skill repo-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/repo-architecture, .gemini/skills/repo-architecture, .github/skills/repo-architecture and .opencode/skills/repo-architecture in your project.

What does Repo Architecture need to run?

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

Does Repo Architecture 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 Repo 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 Repo Architecture use?

Repo Architecture has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Repo Architecture use?

About 403 tokens (SKILL.md is roughly 1.6k 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 Repo Architecture?

Skills that share tags, products or a category with Repo Architecture: Skill Creator (Azure/azqr, 796 stars), Claude Code Skill Developer Guide (diet103/claude-code-infrastructure-showcase, 10k stars), Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars) and Claude Code Command Development (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Repo Architecture?

inbrainfun (a GitHub user) maintains it in inbrainfun/inbrain, which has 142 GitHub stars. The repository holds 52 skills in this directory. The repository was last updated on July 17, 2026.

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