# Ki Stack Render

> |

- **Type:** Skill
- **Install:** `agentstack add skill-milind220-ki-stack-ki-stack-render`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Milind220](https://agentstack.voostack.com/s/milind220)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Milind220](https://github.com/Milind220)
- **Source:** https://github.com/Milind220/Ki-Stack/tree/main/skills/ki-stack/ki-stack-render

## Install

```sh
agentstack add skill-milind220-ki-stack-ki-stack-render
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# ki-stack-render

## Purpose

This skill teaches the agent how to turn KiCad design artifacts into visual outputs.

It is the canonical `ki-stack` skill for:

- schematic rendering
- PCB 2D rendering
- PCB 3D raster rendering
- symbol rendering
- footprint rendering
- SVG to PNG conversion when raster images are needed
- before/after visual verification

## When to use it

Use this skill when the user asks to:

- render a schematic sheet or whole schematic
- render a board or a specific layer set
- get a visual look at a symbol or footprint
- export PDF or SVG deliverables
- generate a PNG/JPEG screenshot-like artifact
- verify that a change actually looks correct

## Shared assumptions

- Prefer `kicad-cli` as the default render path.
- Prefer deterministic exports over GUI screenshots.
- If the model needs raster images and the CLI emits SVG, convert the SVG to PNG.
- Always report exact command lines and output paths.

## Phase 1: Orient

1. Locate `kicad-cli`:

   ```bash
   skills/ki-stack/bin/kicad-cli-path
   ```

2. Detect the version:

   ```bash
   skills/ki-stack/bin/kicad-version
   ```

3. If the input path is unclear, find likely KiCad files:

   ```bash
   skills/ki-stack/bin/kicad-project-find 
   ```

## Phase 2: Identify render target

Choose one of these target classes:

- schematic
- pcb-2d
- pcb-3d
- symbol
- footprint

Map the request to the target class before choosing the command.

Examples:

- "Show me this board" -> `pcb-2d` or `pcb-3d`
- "Render this symbol" -> `symbol`
- "Give me a screenshot of the footprint" -> `footprint`
- "Visualize page 2 of the schematic" -> `schematic`

## Phase 3: Render

Use the helper wrapper whenever possible.

### Schematic SVG

```bash
skills/ki-stack/bin/kicad-render schematic-svg design.kicad_sch out_dir
```

### Schematic PDF

```bash
skills/ki-stack/bin/kicad-render schematic-pdf design.kicad_sch design.pdf
```

### PCB SVG

```bash
skills/ki-stack/bin/kicad-render pcb-svg board.kicad_pcb out_dir --layers F.Cu,F.SilkS,Edge.Cuts --mode-single
```

### PCB PDF

```bash
skills/ki-stack/bin/kicad-render pcb-pdf board.kicad_pcb board.pdf --layers F.Cu,F.SilkS,Edge.Cuts --mode-single
```

### PCB 3D PNG/JPEG

```bash
skills/ki-stack/bin/kicad-render pcb-render board.kicad_pcb board.png --width 1800 --height 1200 --side top
```

### Symbol SVG

```bash
skills/ki-stack/bin/kicad-render symbol-svg library.kicad_sym out_dir --symbol Device:R
```

### Footprint SVG

```bash
skills/ki-stack/bin/kicad-render footprint-svg my.pretty out_dir --footprint SOIC-8_3.9x4.9mm_P1.27mm
```

## Phase 4: Convert if needed

If the output is SVG but the downstream model needs PNG:

```bash
skills/ki-stack/bin/kicad-svg-to-png input.svg output.png
```

## Phase 5: Verify

For render tasks, verification means:

- the command succeeded
- the output file exists
- the output format matches what the user asked for
- if this is a before/after check, both paths are preserved and clearly labeled

Prefer a before/after loop for edit verification:

1. render before
2. perform edit
3. render after
4. report both artifact paths

## Phase 6: Report

Always report:

- render target type
- command used
- output path(s)
- any conversion steps used
- any version-specific caveats

## Helper assets

References:

- `skills/ki-stack/references/render-recipes.md`
- `skills/ki-stack/references/version-matrix.md`

Helpers:

- `skills/ki-stack/bin/kicad-cli-path`
- `skills/ki-stack/bin/kicad-version`
- `skills/ki-stack/bin/kicad-project-find`
- `skills/ki-stack/bin/kicad-render`
- `skills/ki-stack/bin/kicad-svg-to-png`

## Guardrails

- If `kicad-cli` is unavailable, stop and report `BLOCKED`.
- If the input type is ambiguous, identify the file type before rendering.
- If a command fails, capture stderr and try a narrower invocation rather than guessing.
- If the user wants a GUI screenshot specifically, say that this skill produces deterministic exports rather than true live GUI screenshots.

## Completion states

- `DONE`: artifact created and path reported
- `DONE_WITH_CONCERNS`: artifact created but format conversion or version caveat exists
- `BLOCKED`: no CLI or render command failed irrecoverably
- `NEEDS_CONTEXT`: missing input path, missing target symbol/footprint name, or output format is unspecified

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Milind220](https://github.com/Milind220)
- **Source:** [Milind220/Ki-Stack](https://github.com/Milind220/Ki-Stack)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-milind220-ki-stack-ki-stack-render
- Seller: https://agentstack.voostack.com/s/milind220
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
