hw:init

hw:init is a skill for Claude Code, Codex from AISEE-LAB/aisee-plugin. It costs 138 tokens per session (2,079 once invoked), scanned A, original, MIT.

A hardware-project setup assistant for embedded systems such as STM32 projects. It can inspect an existing project or create and check a standard project structure during an OpenSpec change, a tracked set of planned project edits.

In plain words
What is it for?
Use it to scan an existing embedded project, or to create and verify its folders, vendor-library locations, Core and Function sections, and configuration contracts. It is intended for the implementation stage of a tracked OpenSpec change.
Why use it?
It reduces mistakes when locating vendor libraries, clock settings, storage settings, and chip-specific files. Read-only scanning helps reveal what an existing CubeMX, Keil, IAR, or CMake project actually contains before changes are planned.

Skill for Claude CodeCodex

Part of the aisee-plugin plugin — 14 skills shipped together

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/aisee-lab/aisee-plugin/hw-init
Any agent
npx skills add AISEE-LAB/aisee-plugin --skill hw-init
Clone the repo
git clone --depth 1 https://github.com/AISEE-LAB/aisee-plugin

Made for: Claude Code, Codex.

Or install aisee-plugin, the plugin that ships this one along with the rest of its 14 skills.

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 hw:init

README.md
[![agentmods](https://agentmods.dev/badge/skills/aisee-lab/aisee-plugin/hw-init.svg)](https://agentmods.dev/skills/aisee-lab/aisee-plugin/hw-init)
Your own site
<a href="https://agentmods.dev/skills/aisee-lab/aisee-plugin/hw-init"><img src="https://agentmods.dev/badge/skills/aisee-lab/aisee-plugin/hw-init.svg" alt="Measured on agentmods" height="20"></a>
Per session 138 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,079 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.00138 $0.02079
Opus 5 $0.00069 $0.01040
Sonnet 5 $0.00028 $0.00416
Haiku 4.5 $0.00014 $0.00208

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

Security

Grade A, and why

hw:init 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 4d 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.

plugins/aisee-plugin/skills/hw-init/SKILL.md · 233 lines

How it starts

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

hw:init

hw:init 是辅助技能,不是主流程节点。

主流程是:

hw:srs -> hw:architecture -> hw:change-plan -> /opsx:new ... -> /opsx:apply

hw:init generate-skeleton 只能在 initialize-hardware-project 这类 OpenSpec change 的实现阶段使用。任何会创建或修改项目文件的初始化都必须被 OpenSpec change 追踪。

Modes

scan-existing

只读扫描已有工程事实,可在 hw:architecture 前使用。

允许:

  • 读取目录结构
  • 读取 .ioc.uvprojx.ewpCMakeLists.txt、Makefile
  • 读取 map、startup、linker/scatter、工程宏、芯片型号配置
  • 读取 SystemClock_Config() 和 vendor configuration
  • 输出事实摘要和缺口

禁止:

  • 创建目录
  • 修改工程文件
  • 添加源码
  • 改 linker/scatter/startup
  • .uvprojx / .ioc

generate-skeleton

创建或校验工程骨架。必须满足:

  • 当前处于 OpenSpec change,例如 initialize-hardware-project
  • 已有 aisee/docs/architecture/*-hw-architecture.md
  • tasks.md 或当前用户请求明确要求使用 hw:init generate-skeleton

生成或修改的文件必须由该 OpenSpec change 追踪。

Inputs

scan-existing 输入:

  • 已存在的基础工程目录
  • .ioc.uvprojx.ewp.ewwCMakeLists.txt、Makefile、vendor SDK
  • SystemClock_Config()、map 文件、启动文件、linker/scatter、工程宏、芯片型号配置

generate-skeleton 输入:

  • openspec/changes/<change>/proposal.md
  • openspec/changes/<change>/source-map.md
  • openspec/changes/<change>/design.md
  • openspec/changes/<change>/hardware-contract.md
  • openspec/changes/<change>/firmware-contract.md
  • openspec/changes/<change>/runtime-contract.md
  • openspec/changes/<change>/tasks.md
  • aisee/docs/architecture/*-hw-architecture.md
  • 可选 docs/modules/*.md

可选参数:

  • --mode scan-existing|generate-skeleton
  • --template mcu-keil|mcu-iar|mcu-gcc-cmake|rtos-cmake|embedded-linux-app|embedded-linux-bsp|fpga-host|generic-library|custom

References

模板选择时读取:

assets/project-templates.md

项目结构说明生成时读取:

assets/project-structure-template.md

MCU 工程时钟契约生成时读取:

assets/clock-contract-template.md

MCU 存储与型号契约生成时读取:

assets/memory-device-contract-template.md

报告生成时读取:

assets/init-report-template.md

Output

scan-existing 输出:

  • 聊天中的只读扫描摘要,或用户明确要求时写入 aisee/docs/requirements/<YYYY-MM-DD>-<slug>-scan.md
  • 不创建长期工程契约,除非用户明确要求且不修改项目文件

Read the full file on GitHub · 233 lines

Files

What ships with it

7 files 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. 4d ago First seen · 233 lines · 138 tokens per session scan A 453222ec788c

Subscribe to this mod's changes

hw:init is a skill published in the GitHub repository AISEE-LAB/aisee-plugin (11 stars, last pushed 2mo ago), licensed MIT. It adds 138 tokens to every session and 2,079 once invoked, about $0.0007 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-30.

Related

Other skills, from other repositories

hardcoded-secret-detection

Detect hardcoded secrets in code or configuration accessible to the target agent. Focuses on secrets embedded in source, configs, or IaC, not runtime leaks.

Tencent/AI-Infra-Guard · 38 tokens

chart-embedded-export

从结构化数据中提取分类分布执行清洗与统计,生成多维度交叉分析、高分辨率对比图表及包含下载链接的完整分析报告,适用于大文件处理与嵌入式可视化场景。.

OpenSenseNova/SenseNova-Skills · 62 tokens

serve-sim-placeholder-assets

Audit and update serve-sim's Device Hub-style simulator placeholder assets from local Xcode/CoreTypes resources. Use after installing a new Xcode or macOS seed, or when iPhone, iPad, Watch, or Vision placeholder previews look wrong.

EvanBacon/serve-sim · 56 tokens

system-design-artifact-intake

Ingest a provided design artifact - screenshot, drawio, Mermaid, PlantUML, Excalidraw, slides, PDF, or IaC - into a reviewable fact sheet. Probes for embedded structure before vision, marks per-edge confidence, treats extracted text as data. Use when someone hands over a design to review.

HoangNguyen0403/agent-skills-standard · 74 tokens

openase-platform

Platform operations for tickets, projects, and runtime coordination inside OpenASE.

PacificStudio/openase · 18 tokens

andrew-von-nagy-perspective

Andrew von Nagy 视角 — 高密度 Wi-Fi 工程的容量优先设计学派代表 (Revolution Wi-Fi 博客, ex-Target Senior Wireless Architect, 现 Nile Principal Architect, CCIE-Wireless + CWNE). 加载后让 AI 用「capacity-first」「retry-rate-over-RSSI」「predictive-must-validate」「client-is-weakest-link」「spectrum-is-shared」五大镜片诊断企业 Wi-Fi 问题, 特别是高密度场景 (≥30 客户端共享区域, 典型 80…

swaylq/master-skill · 181 tokens