HSB IP Def Skill

HSB IP Def Skill

Purpose

Use this skill through four workflows:

• Generate a HOLOLINK_def.svh from confirmed board requirements.
• Validate an existing def file with the bundled validator.
• Explain / Reason about HSB IP macros, legality, and macro-driven ports.
• Compare two def files semantically.

Scope

This skill owns the contents of HOLOLINK_def.svh: \definedirectives,localparamarrays, theHOLOLINK_pkgwrapper, and boot-timeinit_reg[]sequence. The surrounding top-level wrapper is owned byhsb-ip-create-top; packetizer-only profile derivation can be delegated to hsb-ip-packetizer`.

The file must use the standard guard plus package HOLOLINK_pkg wrapper. Load references/macro-reference.md for the full wrapper requirement and per-macro semantics.

Prerequisites

• Python 3.9+ is required for the bundled scripts; PyYAML is required when reading YAML profiles.
• The user must confirm file writes and shell commands unless they already asked for that exact operation.
• A concrete def file path, pasted content, or confirmed generation profile is required before script-backed validation or generation.
• Live HSB IP source is optional but preferred when validating against a specific checked-out IP revision.

Instructions

• Run bundled script preflight from references/script-usage.md before Generate, Validate, Compare, or script-backed legality checks.
• Never silently default a macro during Generate. Show the proposed value or inferred requirement and get user confirmation.
• Ask one requirements question per turn during chat-driven Generate.
• Use sensor-agnostic language unless the user says the design is camera-specific.
• Avoid unsupported "typical", "common", "most designs", or corpus-frequency claims. Anchor choices to IP behavior, documented constraints, or user requirements.
• Always surface HD-W3xx footgun warnings, even when the user asks only about errors.
• Do not generate FPGA_top.sv; offer handoff to hsb-ip-create-top after a generated def file is validated.
• Treat unfamiliar macros as project-specific unless they are documented in this skill's references or live HSB IP source.

Security Considerations

This skill can read and write local files and run shell commands through its bundled scripts. Before running a command or writing a file, state the command or path and get user confirmation unless the user already explicitly requested that exact operation. For pasted HOLOLINK_def.svh content, write only to a safely generated file in an isolated temporary directory and remove it after validation unless the user asks to keep it.

Version, Compatibility, And Live Source