ki-stack-orient

A starting guide for KiCad, a tool for designing circuit boards, that locates project files and checks which KiCad automation options are available. It helps choose between live editor control, command-line tools, and structured file edits.

In plain words
What is it for?
Use it at the beginning of KiCad work to orient yourself, find the project, check the installed tools, and select a suitable workflow for editing, rendering, verification, or parts search.
Why use it?
It prevents choosing the wrong way to handle a KiCad task, especially when the task depends on the current board selection, rendering, or file structure.

Skill for Claude CodeCodex

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.

agentmods
npx agentmods add skills/milind220/ki-stack/ki-stack-orient
Any agent
npx skills add Milind220/Ki-Stack --skill ki-stack-orient
Clone the repo
git clone --depth 1 https://github.com/Milind220/Ki-Stack

Made for: Claude Code, Codex.

Per session 64 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,419 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00064 $0.01419
Opus 5 $0.00032 $0.00709
Sonnet 5 $0.00013 $0.00284
Haiku 4.5 $0.00006 $0.00142

Measured 2d ago against content hash e5dc839f2fa6, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

ki-stack-orient 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 2d 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/ki-stack/ki-stack-orient/SKILL.md · 137 lines

How it starts

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

ki-stack-orient

Preamble (run first)

Run this before choosing a KiCad workflow:

KI_STACK_DIR="${KI_STACK_DIR:-skills/ki-stack}"
"$KI_STACK_DIR/bin/ki-stack-update-check" 2>/dev/null || true
"$KI_STACK_DIR/bin/kicad-project-find" . 2>/dev/null | sed -n '1,80p' || true
"$KI_STACK_DIR/bin/kicad-version" 2>/dev/null || true
"$KI_STACK_DIR/bin/kicad-python-smoke" 2>/dev/null || true

Read these when the task touches the area:

  • skills/ki-stack/ETHOS.md
  • skills/ki-stack/references/version-matrix.md
  • skills/ki-stack/references/render-recipes.md
  • skills/ki-stack/references/ipc-recipes.md
  • skills/ki-stack/references/ipc-board-workflows.md
  • skills/ki-stack/references/file-editing-recipes.md

Stack Rules

  • PCB editor interaction or current selection: use kicad-python IPC.
  • Render, import/export, DRC, ERC, fabrication, 3D outputs: use kicad-cli.
  • Schematic/library/project file edits: use kicad-skip, kiutils-rs, or another structured parser. Do not hand-roll S-expression edits when a parser fits.
  • Parts search and KiCad-ready vendor artifacts: check https://pcbparts.dev/ early.
  • File format truth: use KiCad developer file-format docs at https://dev-docs.kicad.org/en/file-formats/.
  • No success claim without evidence: artifact path, DRC/ERC output, changed file list, or script output.

Completion Status

  • DONE: completed and verified.
  • DONE_WITH_CONCERNS: completed but proof is partial, version-limited, or blocked by pre-existing issues.
  • BLOCKED: prerequisite unavailable or command failed after a concrete attempt.
  • NEEDS_CONTEXT: target file, object, board session, or intended result is unclear.

Purpose

This is the first skill for KiCad work. It makes the agent stop guessing and quickly answer:

  1. What KiCad files are present?
  2. What KiCad version and CLI are available?
  3. Are Python IPC bindings installed?
  4. Is a live KiCad board reachable?
  5. Which substrate should do the work?

Read the full file on GitHub · 137 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. 2d ago First seen · 137 lines · 64 tokens per session scan A e5dc839f2fa6

Subscribe to this mod's changes

ki-stack-orient is a skill published in the GitHub repository Milind220/Ki-Stack (8 stars, last pushed 3mo ago), licensed MIT. It adds 64 tokens to every session and 1,419 once invoked, about $0.0003 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

plan-pcb-routing

Analyzes a KiCad PCB file and creates a comprehensive routing plan. Examines components for fanout needs (BGA/QFN/QFP/PGA), identifies differential pairs, categorizes power/ground nets, and presents a step-by-step routing workflow with explanations.

drandyhaas/KiCadRoutingTools · 58 tokens

plan-pcb-placement-and-routing

Plans a KiCad PCB end to end when ONE run must both place and route it. Sequences the placement skill and the routing skill, and owns the rules that exist only when the two meet: that placement invalidates every downstream routed board, that a routing failure must be classified before it is retried, and that a…

drandyhaas/KiCadRoutingTools · 103 tokens

plan-pcb-placement

Analyses a KiCad PCB's PLACEMENT and produces a placement plan. Measures whether the board should be placed or re-placed at all and decides from that measurement, detects an unplaced board, separates the parts whose position is a mechanical fact from the ones a search may move, reconstructs a damaged placement…

drandyhaas/KiCadRoutingTools · 115 tokens

find-high-speed-nets

Analyzes a KiCad PCB to identify high-speed and impedance-controlled nets by looking up component datasheets via AI. Classifies nets by speed tier (ultra-high/high/medium/low), detects RF/antenna feeds and other controlled-impedance nets, estimates max frequencies and rise times per interface, and recommends GND…

drandyhaas/KiCadRoutingTools · 133 tokens

review-routed-board

Post-route QA on a KiCad board. Runs the DRC, connectivity, and orphan-stub checkers, verifies length/time-match groups landed within tolerance, checks GND return via coverage on high-speed nets, and reviews differential pairs. Produces a pass/fail sign-off report with concrete next actions. Works on boards routed by…

drandyhaas/KiCadRoutingTools · 83 tokens

stress-test-router

Stress-tests the router against real-world open-source KiCad boards (downloaded, normalized, stripped of routing), measuring routing completion rates and DRC violations per board. Aggregates results and files GitHub issues for new router/parser findings after user approval. Use to regression-test the router at scale…

drandyhaas/KiCadRoutingTools · 69 tokens