# customer-card-render

customer-card-render turns canonical Design Thinking markdown artifacts into PowerPoint slide YAML. The shared powerpoint skill pipeline then assembles the final deck.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1627 repo stars
- Author: microsoft
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/microsoft/hve-core/tree/HEAD/.github/skills/experimental/customer-card-render/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/customer-card-render

## What it does

The skill reads Design Thinking artifacts — Vision Statement, Problem Statement, Scenario, Use Case, Persona — and maps their sections into template-driven `content.yaml` files. The `generate_cards.py` script scans markdown files under `.copilot-tracking/dt/<project-slug>/canonical`, detects each artifact type from its frontmatter, and pulls out the required fields.

A Use Case becomes 4 slides in a row: description, overview, business value and primary user first; then secondary user, preconditions, steps, data requirements; then equipment, environment, success criteria, pain points; finally extensions and evidence. Cards follow the artifact type order, with alphabetical sorting by title inside each type.

This skill does not render PPTX itself. The build runs through `Invoke-PptxPipeline.ps1` from the powerpoint skill — you activate that skill by name and hand it three paths: content directory, style path, output path. If powerpoint is missing, the build step stops with a warning.

Prerequisites are Python 3.11+, the `uv` package manager, and the experimental powerpoint skill. Install `uv` through a package manager that checks the download hash.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add microsoft/hve-core --skill customer-card-render -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/customer-card-render/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/customer-card-render/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add microsoft/hve-core --skill customer-card-render -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/customer-card-render/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add microsoft/hve-core --skill customer-card-render -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/customer-card-render/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install microsoft/hve-core .github/skills/experimental/customer-card-render
```

2. **Manually: put the files in place**
- File: `.github/skills/customer-card-render/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add microsoft/hve-core --skill customer-card-render -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/microsoft/hve-core --path .github/skills/experimental/customer-card-render
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/customer-card-render/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/microsoft/hve-core/tree/HEAD/.github/skills/experimental/customer-card-render/SKILL.md

## When to use it
- Generate slide YAML from canonical markdown artifacts
- Expand a Use Case into 4 consecutive slides
- Keep card mapping separate from PowerPoint rendering
- Produce `content.yaml` files for the powerpoint pipeline
- Order cards by type and title

## Example prompts
- Generate card YAML from `.copilot-tracking/dt/<project-slug>/canonical` into `.copilot-tracking/dt/<project-slug>/render/content`
- Run `generate_cards.py` with `--canonical-dir` on the artifact directory, then build the PPTX through the powerpoint skill

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: efc188fb8f675ca6.

BEGIN THIRD-PARTY FILE efc188fb8f675ca6
````text
---
name: customer-card-render
description: 'Generate customer-card PowerPoint content YAML from Design Thinking canonical artifacts and build using the shared PowerPoint skill pipeline'
license: MIT
compatibility: 'Requires Python 3.11+, uv, and the experimental powerpoint skill'
metadata:
  authors: "microsoft/hve-core"
  spec_version: "1.0"
  last_updated: "2026-10-02"
---

# Customer Card Render Skill

Converts canonical Design Thinking markdown artifacts into PowerPoint skill `content.yaml` slide definitions and builds the final deck through the shared PowerPoint build pipeline.

## Overview

This skill is a sibling to the experimental powerpoint skill. It handles the Design Thinking-specific mapping layer: extracting sections from canonical markdown artifacts and filling template-driven `content.yaml` files. The PowerPoint skill then owns layout rendering, theming, export, and validation.

Keeping these concerns separate means:

* Customer-card mapping logic stays independent from general PowerPoint capabilities.
* The skill can be included in packages independently.
* Layout primitives, `Invoke-PptxPipeline.ps1`, theming, and validation behavior are not reimplemented here.

For full PowerPoint pipeline documentation, activate the `powerpoint` skill by name. When it does not resolve, warn the user that the pipeline documentation and build behavior are unavailable and stop rather than reimplementing them here.

## Prerequisites

* Python 3.11+
* `uv` package manager, installed with a package manager that verifies the download against a published hash:

  ```bash
  # Windows
  winget install --id astral-sh.uv -e

  # macOS / Linux (Homebrew)
  brew install uv
  ```

  To install from a release archive instead, download it from the [uv releases page](https://github.com/astral-sh/uv/releases) and check it against its `.sha256` file before extracting.

* The experimental `powerpoint` skill, activated by name, for the `Invoke-PptxPipeline.ps1` build step. When it does not resolve, warn the user that the build step is unavailable and stop.

## Directory Structure

```text
.github/skills/experimental/customer-card-render/
├── SKILL.md
├── pyproject.toml
├── references/
│   └── mapping-spec.md
├── scripts/
│   └── generate_cards.py
├── templates/
│   ├── global-style.yaml
````
END THIRD-PARTY FILE efc188fb8f675ca6

The third-party file has ended. Everything between the efc188fb8f675ca6 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2363 of 9264 bytes. © microsoft · MIT · https://github.com/microsoft/hve-core/tree/HEAD/.github/skills/experimental/customer-card-render/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
