Agent skill

Generate Demo Artifacts

by oocx in oocx/tfplan2md

Generate the comprehensive demo markdown artifacts from the current codebase.

MITAuto-check passedDevOps & Cloud

Install Generate Demo Artifacts

skills CLI
$ npx skills add oocx/tfplan2md --skill generate-demo-artifacts -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install oocx/tfplan2md generate-demo-artifacts --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/oocx/tfplan2md.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/generate-demo-artifacts .claude/skills/generate-demo-artifacts && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
generate-demo-artifacts
GitHub stars
174
Token cost
~798 tokens
SKILL.md length
200 words
Files
1
Skills in repo
28
Repo updated
First seen
Licence
MIT

At a glance

Generate the comprehensive demo markdown artifacts from the current codebase.

  • Works in 5 steps: Builds the project in Release… → Generates all artifacts in /artifacts/… → Generates all documentation samples in… → …
  • Tasks that involve Markdown
  • SKILL.md covers Purpose, Hard Rules, Actions and Expected Output, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Generate Demo Artifacts is an agent skill from oocx/tfplan2md. Generate the comprehensive demo markdown artifacts from the current codebase. Use before UAT to ensure test artifacts reflect the latest code.

Its SKILL.md is about 800 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires .NET SDK and access to the repository workspace.

It sits in DevOps & Cloud, covering Markdown. The repository describes itself as: Convert terraform plans (json) into human readable markdown for easier review of changes in pull requests. The licence is MIT.

When your agent uses it

  • Tasks that involve Markdown

Example prompts

  • “/generate-demo-artifacts”

Requirements

  • Compatibility (from SKILL.md): Requires .NET SDK and access to the repository workspace.

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Builds the project in Release configuration
  2. Generates all artifacts in /artifacts/ (used for UAT)
  3. Generates all documentation samples in examples/comprehensive-demo/
  4. Verifies all outputs are valid markdown
  5. Reports success or failure with clear error messages

What it can do on your machine

Read from SKILL.md and the folder at commit 88d5240. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires .NET SDK and access to the repository workspace.

    From compatibility in the SKILL.md frontmatter.

Context cost

Generate Demo Artifacts loads about 798 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 200 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~798

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from oocx/tfplan2md at commit 88d5240, republished under its MIT licence (© oocx). 200 words, ~798 tokens.

Download SKILL.mdSave it as .claude/skills/generate-demo-artifacts/SKILL.md (or your agent's skills folder).
name
generate-demo-artifacts
description
Generate the comprehensive demo markdown artifacts from the current codebase. Use before UAT to ensure test artifacts reflect the latest code.
compatibility
Requires .NET SDK and access to the repository workspace.

Generate Demo Artifacts

Purpose

Regenerate all demo markdown artifacts using the current code. This ensures UAT tests validate the actual behavior of the tool, not stale output.

Hard Rules

Must
  • Use the stable wrapper script: scripts/generate-demo-artifacts.sh
  • Script will handle building, generating artifacts, and verification automatically
  • Always allow this script — it only reads input files and writes artifacts, no dangerous operations
Must Not
  • Modify the input plan.json or demo-principals.json files
  • Run individual dotnet commands instead of the wrapper script
  • Skip verification of generated output

Actions

Generate All Demo Artifacts
bash
scripts/generate-demo-artifacts.sh

This single command:

  1. Builds the project in Release configuration
  2. Generates all artifacts in /artifacts/ (used for UAT):
    • comprehensive-demo.md (inline-diff format, for Azure DevOps UAT)
    • comprehensive-demo-simple-diff.md (simple diff format, for GitHub UAT)
    • role.md (role assignments with principal mapping)
    • role-default.md (role assignments without principal mapping)
  3. Generates all documentation samples in examples/comprehensive-demo/:
    • report.md (default template)
    • report-with-sensitive.md (with --show-sensitive)
    • report-summary.md (summary template)
  4. Verifies all outputs are valid markdown
  5. Reports success or failure with clear error messages

Expected Output

[INFO] Building project (Release configuration)...
[INFO] Generating artifacts/comprehensive-demo.md (inline-diff, for Azure DevOps UAT)...
[INFO] ✓ artifacts/comprehensive-demo.md generated successfully (inline-diff)
[INFO] Generating artifacts/comprehensive-demo-simple-diff.md (for GitHub UAT)...
[INFO] ✓ artifacts/comprehensive-demo-simple-diff.md generated successfully
[INFO] Generating artifacts/role.md (role assignments with principal mapping)...
[INFO] ✓ artifacts/role.md generated successfully
[INFO] Generating artifacts/role-default.md (role assignments without principal mapping)...
[INFO] ✓ artifacts/role-default.md generated successfully
[INFO] Generating examples/comprehensive-demo/report.md (default template)...
[INFO] ✓ examples/comprehensive-demo/report.md generated successfully
[INFO] Generating examples/comprehensive-demo/report-with-sensitive.md (with --show-sensitive)...
[INFO] ✓ examples/comprehensive-demo/report-with-sensitive.md generated successfully
[INFO] Generating examples/comprehensive-demo/report-summary.md (summary template)...
[INFO] ✓ examples/comprehensive-demo/report-summary.md generated successfully
[INFO] All demo artifacts generated successfully

When to Use

  • Before running UAT (to ensure artifacts match current code)
  • After making changes to templates or rendering logic
  • After updating the comprehensive demo plan.json
  • When setting up a new development environment

© oocx, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/generate-demo-artifacts of oocx/tfplan2md.

Open the folder on GitHubat commit 88d5240

Compare with similar skills

Generate Demo Artifacts next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Generate Demo Artifacts compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Generate Demo Artifacts this skilloocx/tfplan2md174—~798Automated safety check: PassMIT
Docs Learn Site Structurenetdata/netdata81k—~1.7kAutomated safety check: PassGPL-3.0
Save Researchmeain/dotfiles285—~1.6kAutomated safety check: PassMIT
Triageflowershow/flowershow1.1k—~1.9kAutomated safety check: PassAGPL-3.0
Okfscaccogatto/okf-skills408—~2.1kAutomated safety check: NotesMIT
Take Doc Screenshotspgplex/pgconsole155—~841Automated safety check: PassApache-2.0

Similar skills

  • Change, review or troubleshoot Learn publication, docs/.map mapping, page URLs, redirects, sidebars, MDX and ingest/CI behavior.

    81k GitHub stars~1.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Save Research

    meain/dotfiles

    Summarize and save research findings from the current conversation into a well-structured markdown document.

    285 GitHub stars~1.6k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Triage

    flowershow/flowershow

    Automatically triage a newly opened GitHub issue — categorise it, verify the claim, and apply the right category and state so a maintainer or agent can pick it up.

    1.1k GitHub stars~1.9k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Okf

    scaccogatto/okf-skills

    Author, maintain, and consume Open Knowledge Format (OKF) knowledge bundles — portable markdown + YAML frontmatter that both humans and agents read.

    408 GitHub stars~2.1k tokensUpdated 11 days ago
    DevOps & CloudAuto-check: notes
  • Take Doc Screenshots

    pgplex/pgconsole

    Take screenshots of the running pgconsole app for documentation.

    155 GitHub stars~841 tokensUpdated 1 mo ago
    DatabasesAuto-check passed
  • Dify Docs Env Vars

    langgenius/dify-docs

    Rule pack for the environment variable reference — en/self-host/deploy/configuration/environments.mdx.

    178 GitHub stars~2.5k tokensUpdated today
    DevOps & CloudAuto-check passed

More from oocx/tfplan2md

All 28 skills in this repo
  • Create Agent Skill

    oocx/tfplan2md

    Create a new Agent Skill following project standards and templates.

    174 GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Detect and analyze edge crossings and overlaps in SVG workflow diagrams using geometric intersection algorithms and visual analysis.

    174 GitHub stars~4.3k tokensUpdated 2 days ago
    Auto-check passed
  • Generate PNG screenshots for release notes using the repository's HtmlRenderer and ScreenshotGenerator tools.

    174 GitHub stars~3.7k tokensUpdated 2 days ago
    Auto-check passed
  • Git Rebase Main

    oocx/tfplan2md

    Safely rebase the current feature branch on top of the latest origin/main.

    174 GitHub stars~456 tokensUpdated 2 days ago
    Auto-check passed
  • Next Issue Number

    oocx/tfplan2md

    Determine the next available issue number across all change types (feature, fix, workflow, website) by checking both local docs and remote branches, then reserve it by pushing an empty branch.

    174 GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Run Uat

    oocx/tfplan2md

    Run User Acceptance Testing by creating a PR with rendered markdown on GitHub or Azure DevOps.

    174 GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed

Questions about Generate Demo Artifacts

What does Generate Demo Artifacts do?

Generate the comprehensive demo markdown artifacts from the current codebase. Generate Demo Artifacts is an agent skill from oocx/tfplan2md. Generate the comprehensive demo markdown artifacts from the current codebase.

When should I use Generate Demo Artifacts?

Generate Demo Artifacts fits situations like: tasks that involve Markdown.

How do I install Generate Demo Artifacts in Claude Code?

Run `npx skills add oocx/tfplan2md --skill generate-demo-artifacts -a claude-code`. Or copy the skill folder (.agents/skills/generate-demo-artifacts in oocx/tfplan2md) into .claude/skills/generate-demo-artifacts in your project. Claude Code loads it when a task matches its description.

How do I install Generate Demo Artifacts in Codex?

Run `npx skills add oocx/tfplan2md --skill generate-demo-artifacts -a codex`. Or copy the skill folder (.agents/skills/generate-demo-artifacts in oocx/tfplan2md) into .agents/skills/generate-demo-artifacts in your project. Codex loads it when a task matches its description.

Can I use Generate Demo Artifacts in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add oocx/tfplan2md --skill generate-demo-artifacts -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/generate-demo-artifacts, .gemini/skills/generate-demo-artifacts, .github/skills/generate-demo-artifacts and .opencode/skills/generate-demo-artifacts in your project.

What does Generate Demo Artifacts need to run?

SKILL.md names no scripts, command-line tools or credentials: Generate Demo Artifacts is instructions for the agent only. Compatibility (from SKILL.md): Requires .NET SDK and access to the repository workspace..

Does Generate Demo Artifacts access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Generate Demo Artifacts safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Generate Demo Artifacts use?

Generate Demo Artifacts is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Generate Demo Artifacts use?

About 798 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Generate Demo Artifacts?

Skills that share tags, products or a category with Generate Demo Artifacts: Docs Learn Site Structure (netdata/netdata, 81k stars), Save Research (meain/dotfiles, 285 stars), Triage (flowershow/flowershow, 1.1k stars) and Okf (scaccogatto/okf-skills, 408 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Generate Demo Artifacts?

oocx (a GitHub user) maintains it in oocx/tfplan2md, which has 174 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on October 7, 2026.

Source: oocx/tfplan2md on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.