step2-pinmap

step2-pinmap is a skill for Claude Code, Codex from raisoninme/boardless-pcb. It costs 26 tokens per session (1,008 once invoked), scanned A, original, MIT.

A guided workflow step that creates a firmware skeleton and freezes the pin map—the record of which microcontroller pins connect to which board functions.

In plain words
What is it for?
Use it to define the board's pin assignments and firmware interfaces while leaving business logic for later.
Why use it?
It prevents later code or hardware work from silently changing the agreed connections. It also ensures this step begins only after the project requirements and design plan are complete.

Skill for Claude CodeCodex

Written for Claude Code and Codex: disable-model-invocation in frontmatter, but also agents/openai.yaml present. Also seen: mentions Claude Code.

Part of the boardless-pcb plugin — 10 skills, 1 agent shipped together

Good fit Use it to define the board's pin assignments and firmware interfaces while leaving business logic for later.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/raisoninme/boardless-pcb/step2-pinmap
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add raisoninme/boardless-pcb --skill step2-pinmap
Clone the repo
git clone --depth 1 https://github.com/raisoninme/boardless-pcb

Made for: Claude Code, Codex.

Or install boardless-pcb, the plugin that ships this one along with the rest of its 10 skills, 1 agent.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for step2-pinmap

README.md
[![agentmods](https://agentmods.dev/badge/skills/raisoninme/boardless-pcb/step2-pinmap.svg)](https://agentmods.dev/skills/raisoninme/boardless-pcb/step2-pinmap)
Your own site
<a href="https://agentmods.dev/skills/raisoninme/boardless-pcb/step2-pinmap"><img src="https://agentmods.dev/badge/skills/raisoninme/boardless-pcb/step2-pinmap.svg" alt="Measured on agentmods" height="20"></a>
Per session 26 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,008 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00026 $0.01008
Opus 5 $0.00013 $0.00504
Sonnet 5 $0.00005 $0.00202
Haiku 4.5 $0.00003 $0.00101

Measured 8d ago against content hash 9a758fdff37d, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

step2-pinmap scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/step2-pinmap/SKILL.md · 34 lines

How it starts

The opening of the file, as written. The whole thing — 34 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Step 2 · Firmware skeleton / pin map freeze

Session & state check (before touching anything)

  1. One step per session: if this session already did substantive work for another step, stop and ask for a fresh session.
  2. Read docs/flow-state.md (recognize it by its canonical header line; a foreign file under this name → stop and ask). Missing → route the user to step1-onboard (Claude Code: /boardless-pcb:step1-onboard). Confirm step 1 is done; read docs/requirements.md + docs/dev-plan.md. Not satisfied → stop and report; never skip ahead.
  3. This step already done with no issue targeting it → re-run: ask the user's intent before redoing anything. Already in-progress → a previous session aborted or another session is live: ask before proceeding. Marked rework → redo what the rework note in its row requires, then wrap up.
  4. Issues-table entries with target step = 2 → fix mode (below).
  5. Set step 2 in-progress. Rebuild context from disk only; rely on no conversation memory.

Execute

Adopt-and-audit path: if flow-state/requirements record an inherited pin map (inherited: <path>), do not re-derive it — ingest it into this flow's carriers (pin-map carrier + docs/pinmap.md), then audit at the depth its trust level prescribes: verified-rely-on → dual-source spot-check of the critical pins (boot/strapping, wake sources, bus sharing, reset defaults); reference-only → full dual-source verification of every pin. Inheritance changes the labor, never the bar: the checklist below, the gate, and the done criteria apply unchanged — an inherited pin map is a memory-grade prior, and priors only qualify as triggers for checks.

  • Pin layer fully realized: gate polarities (active-low/high); if the design sleeps and wakes — your platform's wake semantics (level-triggered wake is not an edge event; e.g. on ESP32's EXT1 ANY_LOW mask, a pin currently low must never enter the mask — check the target MCU's equivalent rules); boot-mode/strapping-class pin constraints; bus sharing; every pin's reset default state with its safety implications.
  • Input pins at a boundary where their driver's domain may power down get default pull resistors (a floating input invites shoot-through current).
  • Business logic interface-only: control logic and modules as skeletons with frozen signatures; details iterate in step 7. Firmware at this step exists to produce pin constraints.
  • Pin-level decision code must prove its pins are configured (idempotent reconfigure + guard assertions), with the rule captured in host unit tests.
  • Dual-source verification for every pin: official datasheet page-by-page × EDA symbol library; the datasheet wins on conflict; log each check (pin, both sources, verdict) into the pinmap doc.

Read the full file on GitHub · 34 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 34 lines · 26 tokens per session scan A 9a758fdff37d

Subscribe to this mod's changes

step2-pinmap is a skill published in the GitHub repository raisoninme/boardless-pcb (2 stars, last pushed 25d ago), licensed MIT. It adds 26 tokens to every session and 1,008 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

kicad-jlcpcb-workflow

Use this skill when the user asks to "design a PCB", "make a board", "build a PCB project", "order from JLCPCB", "create a schematic", "source LCSC parts", "wire up a board", "generate a PCB from a BOM", or any KiCad + JLCPCB workflow. Also use when working with .kicadpro or .kicadpcb files. Phase 1.6 handles project…

BeckhamLabsLLC/kicad-jlcpcb · 145 tokens

spark-environment-setup

Set up a working ML training/inference environment on NVIDIA DGX Spark (GB10, aarch64, CUDA 13). Use when installing PyTorch/Unsloth/TRL/vLLM on DGX Spark, hitting libcudart or wheel-ABI errors on aarch64, or choosing between NGC containers and bare pip installs.

wshobson/agents · 76 tokens

spark-training-gotchas

Preflight and diagnose the ten known failure modes for ML training on NVIDIA DGX Spark. Use when a training run on DGX Spark fails to start, OOMs below the 128GB limit, slows down mid-run, or before any multi-hour training job on GB10.

wshobson/agents · 63 tokens

kicad

Analyze KiCad projects and PDF schematics: schematics, PCB layouts, Gerbers, footprints, symbols, netlists, and design rules. Reviews designs for bugs, traces nets, cross-references schematic to PCB, extracts BOM data, checks DRC/ERC, DFM, power trees, and regulator circuits. Every finding carries a confidence label…

aklofas/kicad-happy · 240 tokens

lcsc

Search LCSC Electronics for electronic components — find parts by LCSC number (Cxxxxx) or MPN, check stock/pricing, download datasheets, analyze specifications. Sister company to JLCPCB, same parts library. Sync and maintain a local datasheets directory for a KiCad project, or use batch MPN-list seeding (--mpn-list)…

aklofas/kicad-happy · 174 tokens

pcbway

PCBWay PCB fabrication and assembly — turnkey/consigned assembly, design rules, ordering workflow. Alternative to JLCPCB for manufacturing. Use with KiCad. Use this skill when the user mentions PCBWay, needs turnkey assembly (PCBWay sources parts by MPN), has parts not available on LCSC, needs assembled boards with…

aklofas/kicad-happy · 119 tokens