Skip to content

Guide · Agent skill

How to use the Engineering Blueprint Deck agent skill (hps-true-blueprint)

Updated · written with AI from the project's own documentation and checked against our catalogue data

hps-true-blueprint is an agent skill that tells a compatible AI agent to build an architecture review presentation as one HTML file in a fixed engineering-blueprint style. It is aimed at teams that want a consistent technical-looking deck and at people who already know the OpenDesign project structure. After reading this guide you will know what the skill does, how to install it, how to ask for a deck and what to check before presenting.

Engineering Blueprint Decknexu-io/open-design · Apache-2.0

Quick start

  1. 1Check requirements. Confirm your agent runtime loads SKILL.md skills, such as Claude Code, and that you have a web browser.
  2. 2Download the ZIP. Download the skill ZIP from this page.
  3. 3Unzip the skill. Unzip it into ~/.claude/skills/ for personal use or into a project's .claude/skills/ folder for one project.
  4. 4Or upload in Claude apps. In the Claude apps, go to Settings → Capabilities → Skills and upload the skill.
  5. 5Describe the architecture and audience. Ask for an architecture review deck in this style, naming the audience and the decision you need.
  6. 6Answer the agent's questions. Provide the missing essentials it asks for, such as must-keep numbers and source materials.
  7. 7Open and review the HTML. Open the generated single HTML file in a browser, replace any example text, and have a technical reviewer check it.

What is an agent skill?

An agent skill is a folder containing a SKILL.md file that gives an AI agent instructions for one kind of task. When the skill is installed and the agent runtime loads it, the agent can follow those instructions when a request matches the skill's triggers.

This skill needs a runtime that loads SKILL.md skills, for example Claude Code or another agent with skill support.

What the skill makes the agent produce

The agent builds a single-file HTML slide presentation in a locked visual theme: dark blue background, white grid lines, dashed boxes, monospace lettering and amber annotations. It starts from a seed file called example.html, keeps the design rules and navigation script intact, and replaces only the slide content with your material.

The skill also frames the deck as a decision-focused product-management presentation for an engineering audience. Its critic check asks whether reviewers can agree on a next step.

  • Output: one HTML file with slides, including simple inline diagrams of system parts
  • Theme is locked: no theme switching, no palette or font changes
  • Speaker notes are included as hidden text on each slide

Install the skill

Download the ZIP for this skill from this page and unzip it. Then place the skill folder in one of these locations, depending on how you want it available:

  • Personal: unzip into ~/.claude/skills/
  • Single project: unzip into the project's .claude/skills/ folder
  • Claude apps: upload the skill under Settings → Capabilities → Skills

Trigger the skill with a natural request

Describe the architecture you want to present and name the audience. The skill's triggers include phrases such as 'html deck', 'html slides', 'architecture', 'roadmap' and 'product'. Ask for a deck in this style and say what decision the meeting should reach.

The source says the agent should ask first for missing essentials: audience, decision target, source-of-truth materials, deadline and must-keep numbers. Answer those questions so the content is grounded in your facts.

Example request

A request along these lines works well. Replace the bracketed parts with your own material.

Using the engineering blueprint deck skill, make a decision-focused architecture review deck as a single HTML file. Audience: platform engineering. Decision: approve the sandbox boundary change. Use our real numbers: [your figures]. Start from example.html and replace the content only.

Safety notes: scripts and network

The skill does not run scripts. It does use the network: the deck loads JetBrains Mono from Google Fonts unless that font is available locally. Internet access is optional. Open the resulting HTML file in a web browser to view it.

  • Replace the example content with real facts you provide; the example text is not a source of truth
  • Have a technical reviewer check any architecture claims before the deck is presented
  • The skill forbids changes to the theme, so it is not suited to light, branded or flexible styling

Tips for better results

Give the agent source material such as design notes or diagrams in text form, and state the numbers that must stay exact. The skill's own file says to use real content rather than placeholder text, so vague requests tend to produce less useful slides.

  • Name the decision you want reviewers to make
  • Keep each slide to one idea; the skill splits content into more slides rather than scrolling
  • Check speaker notes, which are hidden in the page, before presenting

What people use it for

  • A platform team presents how a sandbox, sidecar and daemon fit together before a design decision
  • A product manager builds a consistent architecture review deck that engineers recognise at a glance
  • A team adapts the OpenDesign-style structure for its own system by replacing the example content with its facts

Frequently asked questions

How do I install the hps-true-blueprint skill?

Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder. In the Claude apps you can instead upload it under Settings → Capabilities → Skills.

What do I need to run it?

You need an agent runtime that loads SKILL.md skills, such as Claude Code, and a web browser to open the resulting HTML file. Internet access is optional because the deck loads JetBrains Mono from Google Fonts unless the font is available locally.

Is the hps-true-blueprint skill free to use?

The skill is listed under the Apache-2.0 licence. This page does not list pricing, so check the licence file and your agent runtime's terms for any costs.

Can I change the colours or theme?

No. The skill locks the theme and forbids palette mixing or font changes, so it is not suited to light, branded or flexible themes.

Does the skill run scripts or access the internet?

The skill does not run scripts. It does use the network, because the deck loads JetBrains Mono from Google Fonts unless the font is available locally.

Why does my deck show example content?

The skill starts from example.html and replaces its content with yours. If the agent leaves example material in place, ask it to replace all of it with real facts you provide.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Use this skill if you want a consistent, technical-looking architecture review deck as a single HTML file and you are happy with a locked dark-blue theme. Pick a different tool if you need a light, branded or flexible theme, or if you need a deck on a system other than OpenDesign, since the content is centred on OpenDesign's architecture.

Download the skill