Agent skill

Breadboarding

by koolamusic in koolamusic/claudefiles

Transform a workflow description into affordance tables showing UI and Code affordances with their wiring.

MITAuto-check passed

Install Breadboarding

skills CLI
$ npx skills add koolamusic/claudefiles --skill breadboarding -a claude-code

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

GitHub CLI
$ gh skill install koolamusic/claudefiles breadboarding --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/koolamusic/claudefiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/breadboarding .claude/skills/breadboarding && 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
breadboarding
GitHub stars
130
Token cost
~1.3k tokens
SKILL.md length
553 words
Files
10 (incl. scripts, references)
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Transform a workflow description into affordance tables showing UI and Code affordances with their wiring.

  • Works in 3 steps: Mapping an Existing System → Designing from Shaped Parts → Mixtures
  • Map existing systems
  • SKILL.md covers Use Cases, Core Concepts, The Output: Affordance Tables and References
  • Runs Shell scripts from its folder

What it does

Breadboarding is an agent skill from koolamusic/claudefiles. Transform a workflow description into affordance tables showing UI and Code affordances with their wiring. Use to map existing systems or design new ones from shaped parts.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including scripts and reference files (for example `references/catalog.md`, `references/concepts.md` and `references/examples.md`).

The repository describes itself as: A minimal catalog of my favourite skills for working with claude. The licence is MIT.

When your agent uses it

  • Map existing systems
  • Design new ones from shaped parts

Example prompts

  • “/breadboarding”

Requirements

  • A Bash shell

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Mapping an Existing System
  2. Designing from Shaped Parts
  3. Mixtures

What it can do on your machine

Read from SKILL.md and the folder at commit 297c432. 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 1 file in scripts/ (Shell), 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.

Context cost

Breadboarding loads about 1.3k tokens when it runs, and up to ~16k if it reads all its reference files. Until then it costs about 47 tokens; SKILL.md has 553 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from koolamusic/claudefiles at commit 297c432, republished under its MIT licence (© koolamusic). 553 words, ~1,268 tokens.

Download SKILL.mdSave it as .claude/skills/breadboarding/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
breadboarding
description
Transform a workflow description into affordance tables showing UI and Code affordances with their wiring. Use to map existing systems or design new ones from shaped parts.

Breadboarding

Breadboarding transforms a workflow description into a complete map of affordances and their relationships. The output is always a set of tables showing numbered UI and Code affordances with their Wires Out and Returns To relationships. The tables are the truth. Mermaid diagrams are optional visualizations for humans.


Use Cases

1. Mapping an Existing System

You have a workflow you're trying to understand. Provide code repo(s) and a workflow description (always from the perspective of an operator trying to make an effect happen). Output: affordance tables + optional Mermaid.

2. Designing from Shaped Parts

You have a new system sketched as an assembly of parts (mechanisms), which is what a shaping pass produces — /grill shape is one way to get there. Provide the parts list, the R (requirement/outcome), and optionally the existing system. Output: affordance tables + optional Mermaid.

3. Mixtures

An existing system that must remain as-is, plus new pieces or changes. Breadboard both together — existing affordances and new ones — showing how they connect.


Core Concepts

Places — A bounded context of interaction. The blocking test: can you interact with what's behind? No → different Place. Yes → same Place with local state changes. Places get IDs (P1, P2...) and can contain subplaces (P2.1, P2.2).

Affordances — Things you can act upon. UI affordances (U): inputs, buttons, displays. Code affordances (N): methods, subscriptions, stores, framework mechanisms.

Wiring — How affordances connect. Wires Out = control flow (what triggers what). Returns To = data flow (where output goes). Navigation wires go to Places, not to affordances inside them.


The Output: Affordance Tables

Every breadboard produces these tables:

Places Table
#PlaceDescription
P1Search PageMain search interface
P2Detail PageIndividual result view
UI Affordances Table
#PlaceComponentAffordanceControlWires OutReturns To
U1P1search-detailsearch inputtype→ N1—
U2P1search-detailloading spinnerrender——
Code Affordances Table
#PlaceComponentAffordanceControlWires OutReturns To
N1P1search-detailactiveQuery.next()call→ N2—
N2P1search-detailactiveQuery subscriptionobserve→ N3—
Data Stores Table
#PlaceStoreDescription
S1P1resultsArray of search results
Show full SKILL.md (217 more words)Show less
Column Definitions
ColumnDescription
#Unique ID (P1, P2... for Places; U1, U2... for UI; N1, N2... for Code; S1, S2... for Stores)
PlaceWhich Place this affordance belongs to (containment)
ComponentWhich component/service owns this
AffordanceThe specific thing you can act upon
ControlThe triggering event: click, type, call, observe, write, render
Wires OutWhat this triggers: → N4, → P2 (control flow, including navigation)
Returns ToWhere output flows: → N3 or → U2, U3 (data flow)

References

Load these progressively as needed:

FileContainsLoad When
concepts.mdPlaces, subplaces, place references, modes, containment vs wiring, navigation wiringYou need to determine Place boundaries or model containment
procedures.mdStep-by-step for mapping existing systems (11 steps) and designing from parts (8 steps)Starting a breadboarding task
principles.mdNever use memory, mechanisms aren't affordances, two flows, data source rules, store placementReviewing or debugging a breadboard
catalog.mdComplete element/relationship reference, qualification criteria, verification checksQuick lookup of what qualifies as what
visualization.mdMermaid conventions, colors, lines, subgraphs, chunking, workflow annotationsCreating or reviewing Mermaid diagrams
slicing.mdVertical slicing methodology, constraints, procedure, visualizationBreaking a breadboard into implementation slices
reflection.mdDesign smell detection, naming test, splitting affordances, fixing wiringReviewing a breadboard for correctness
examples.mdExample A: mapping existing system, Example B: designing from parts + slicingNeed a worked example for reference

© koolamusic, 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 9 other files (scripts, references) in skills/breadboarding of koolamusic/claudefiles.

  • SKILL.md
  • references/catalog.md
  • references/concepts.md
  • references/examples.md
  • references/principles.md
  • references/procedures.md
  • references/reflection.md
  • references/slicing.md
  • references/visualization.md
  • scripts/preview-markdown.sh

Open the folder on GitHubat commit 297c432

Compare with similar skills

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

Breadboarding compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Breadboarding this skillkoolamusic/claudefiles130—~1.3kAutomated safety check: PassMIT
TransformersK-Dense-AI/scientific-agent-skills48k1 repos~2.8kAutomated safety check: NotesApache-2.0
Duplicate Descriptionthedaviddias/Front-End-Checklist74k—~695Automated safety check: PassMIT
Table Fitasgeirtj/system_prompts_leaks69k—~772Automated safety check: PassCC0-1.0
Meta Descriptionthedaviddias/Front-End-Checklist74k—~513Automated safety check: PassMIT
Audio Descriptionsthedaviddias/Front-End-Checklist74k—~549Automated safety check: PassMIT

Similar skills

  • Transformers

    K-Dense-AI/scientific-agent-skills

    Hugging Face Transformers for loading Hub models, running pipeline inference, text generation, and Trainer fine-tuning on NLP, vision, audio, and multimodal tasks.

    48k GitHub starsUsed in 1 repo~2.8k tokens
    AI & LLM EngineeringAuto-check: notes
  • Duplicate Description

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a site's meta tag uniqueness, generating page-specific meta descriptions, or reviewing CMS templates that inject the same description globally.

    74k GitHub stars~695 tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Table Fit

    asgeirtj/system_prompts_leaks

    Keep a Markdown table readable in a narrow terminal of about 100 display columns - a wide table or one carrying prose in its cells wraps into unreadable ragged rows.

    69k GitHub stars~772 tokensUpdated 2 days ago
    Testing & QAAuto-check passed
  • Meta Description

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing page metadata or generating descriptions for new pages.

    74k GitHub stars~513 tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Audio Descriptions

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Provide audio descriptions for video.

    74k GitHub stars~549 tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Table Headers

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Define proper table headers.

    74k GitHub stars~460 tokensUpdated yesterday
    Frontend & DesignAuto-check passed

More from koolamusic/claudefiles

All 13 skills in this repo
  • Explainer Formats

    koolamusic/claudefiles

    A skill your agent uses when asked to explain a topic, codebase, process, or document in a specific output format — plain language or Simplified Technical English (STE, in the style of ASD-STE100…

    130 GitHub stars~1.7k tokensUpdated 2 days ago
    Auto-check passed
  • Orchestrator

    koolamusic/claudefiles

    Turn the current session into a chief-of-staff thread that runs a war room of three role slots — surveyor, executor, auditor — and routes per-branch work to durable, reusable child agents.

    130 GitHub stars~1.7k tokensUpdated 2 days ago
    Auto-check passed
  • Retro

    koolamusic/claudefiles

    A skill your agent uses when a user completes a phase, sprint, milestone, or meaningful unit of work and needs a retrospective.

    130 GitHub stars~2.8k tokensUpdated 2 days ago
    Auto-check passed
  • Skill Creator

    koolamusic/claudefiles

    Guide for creating effective skills. An agent skill from koolamusic/claudefiles.

    130 GitHub stars~1.7k tokensUpdated 2 days ago
    Auto-check passed
  • Debug

    koolamusic/claudefiles

    A skill your agent uses when encountering any bug, test failure, or unexpected behavior, before proposing fixes - four-phase framework with built-in backward tracing for deep-stack failures…

    130 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Grill

    koolamusic/claudefiles

    Adversarial questioning and collaborative shaping in one skill.

    130 GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed

Questions about Breadboarding

What does Breadboarding do?

Transform a workflow description into affordance tables showing UI and Code affordances with their wiring. Breadboarding is an agent skill from koolamusic/claudefiles. Transform a workflow description into affordance tables showing UI and Code affordances with their wiring.

When should I use Breadboarding?

Breadboarding fits situations like: map existing systems; design new ones from shaped parts.

How do I install Breadboarding in Claude Code?

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

How do I install Breadboarding in Codex?

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

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

What does Breadboarding need to run?

Going by SKILL.md and its folder, Breadboarding needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Breadboarding 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 Breadboarding 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Breadboarding use?

Breadboarding 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 Breadboarding use?

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

What are the alternatives to Breadboarding?

Skills that share tags, products or a category with Breadboarding: Transformers (K-Dense-AI/scientific-agent-skills, 48k stars), Duplicate Description (thedaviddias/Front-End-Checklist, 74k stars), Table Fit (asgeirtj/system_prompts_leaks, 69k stars) and Meta Description (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Breadboarding?

koolamusic (a GitHub user) maintains it in koolamusic/claudefiles, which has 130 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 5, 2026.

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