# skill-card-generator

Turns a skill folder that already exists into a draft governance card: it reads the files, writes a context, renders markdown and checks that review markers are gone.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2200 installs · ★ 3735
- Author: Trustworthy AI Projects
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/NVIDIA/skills/tree/HEAD/skills/skill-card-generator/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/skill-card-generator

## What it does

Point it at a skill directory and it produces a draft governance card: what the skill does, which permissions it asks for, what it needs from the machine. The path comes in as an argument. No argument means the current folder.

Three Python scripts carry the work. One scans the target and hands back a report on its files and repo metadata. From that report the agent writes a context JSON, following the per-field hints in `references/style-guide.md`. A Jinja template at `references/skill-card.md.j2` turns the JSON into markdown, and the renderer validates the shape of the context on the way through.

Reads stay inside the target folder plus this skill's own `references/` and `scripts/`. Writes land in the target or `/tmp/`, and shell calls are limited to the three named scripts. `jinja2` must be installed before rendering, and Python 3 is needed from the start. Output is a draft — the validator only fails when VERIFY or SELECT markers survive in the file.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill skill-card-generator -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill skill-card-generator -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill skill-card-generator -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install NVIDIA/skills skill-card-generator
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill skill-card-generator -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/NVIDIA/skills --path skills/skill-card-generator
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/skills --skill skill-card-generator -a opencode
```

### 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/NVIDIA/skills/tree/HEAD/skills/skill-card-generator/SKILL.md

## When to use it
- draft a governance card for an existing skill folder
- refresh a card after the skill itself changed
- pull file and repo metadata out of the target folder
- catch leftover VERIFY and SELECT markers before submitting
- get material ready for legal and safety review

## Example prompts
- Generate a governance card for the skill in `./skills/my-skill`
- Refresh the card for `/path/to/target-skill`, `SKILL.md` has changed
- Build a draft card for the current folder and run the marker check

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

From the same set: [nvidia/skills](https://affpapa.org/en/nevibecode/by/nvidia/skills.md) — 194 cards

---
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