Skip to content

feat: add Claude Code skill for retro style workflow#1

Open
luogao wants to merge 2 commits into
NovusGFX:mainfrom
luogao:feat/claude-code-skill
Open

feat: add Claude Code skill for retro style workflow#1
luogao wants to merge 2 commits into
NovusGFX:mainfrom
luogao:feat/claude-code-skill

Conversation

@luogao

@luogao luogao commented Jun 21, 2026

Copy link
Copy Markdown

Summary

Operationalizes the "Using With AI Coding Agents" workflow already documented in the README. Instead of pointing an agent at a style folder by hand and pasting the prompt template, Claude Code users get a /retro-design command that:

  1. Lists all 53 styles from a compact pre-built index
  2. Recommends 3 candidates from a natural-language vibe ("80s green terminal", "Y2K", "Swiss minimal")
  3. Loads the chosen style's tokens + component patterns
  4. Generates new HTML/CSS reusing the palette, typography, surface treatment, and component markup

Files

  • .claude/skills/retro-design/SKILL.md — entry point, 4-step workflow, era/aesthetic selection cheatsheet
  • .claude/skills/retro-design/references/styles-index.md — compact 53-row catalog (auto-generated)
  • .claude/skills/retro-design/scripts/build-index.mjs — regenerates the index from manifest.json

The skill resolves the repo root at load time via git rev-parse --show-toplevel, so it's portable — no hardcoded paths.

README change

Adds a short "Claude Code users" subsection under "Using With AI Coding Agents" pointing at the skill with example /retro-design invocations.

Maintenance

  • .gitignore excludes .claude/settings.local.json (per-developer Claude Code permissions, not for sharing).
  • After adding/removing styles, run node .claude/skills/retro-design/scripts/build-index.mjs to refresh the index. Same pattern as existing scripts/build-manifest.mjs and scripts/build-tokens.mjs.

Test plan

  • Open this branch in Claude Code, run /retro-design list, confirm 53 rows render.
  • Run /retro-design 80s green terminal, confirm 3 recommendations from the terminal/CRT cluster (09-crt-phosphor, 27-ibm-3270, 32-matrix-rain).
  • Run /retro-design 09-crt-phosphor, confirm the skill loads styles/09-crt-phosphor/index.html and generates a styled component on request.
  • Idempotent: rerun build-index.mjs, no diff in styles-index.md.
  • Maintainer spot-check: pull branch, run node .claude/skills/retro-design/scripts/build-index.mjs from repo root, confirm it writes 53 rows without errors.

🤖 Generated with Claude Code

luogao and others added 2 commits June 21, 2026 16:59
Project-level Claude Code skill that operationalizes the "Using With AI
Coding Agents" workflow from the README. The /retro-design command
lists all 53 styles, recommends candidates from a natural-language
vibe, loads the chosen style's tokens and component patterns, and
generates new HTML/CSS in that visual language.

- SKILL.md: 4-step workflow + era/aesthetic selection cheatsheet
- references/styles-index.md: compact 53-row catalog (auto-generated)
- scripts/build-index.mjs: regenerates the index from manifest.json,
  resolves repo root via import.meta.url (portable, no hardcoded paths)

SKILL.md resolves the catalog root at load time via
`git rev-parse --show-toplevel`, so the repo can be cloned anywhere.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Adds a "Claude Code users" subsection under "Using With AI Coding
Agents" pointing at the bundled .claude/skills/retro-design/ skill
with example /retro-design invocations.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@ecc-tools

ecc-tools Bot commented Jun 21, 2026

Copy link
Copy Markdown

Analyzing 200 commits...

@ecc-tools

ecc-tools Bot commented Jun 21, 2026

Copy link
Copy Markdown

Analysis Complete

Generated ECC bundle from 2 commits | Confidence: 50%

View Pull Request #2

Repository Profile
Attribute Value
Language TypeScript
Framework Not detected
Commit Convention conventional
Test Directory separate
Changed Files (5)
Metric Value
Files changed 5
Additions 210
Deletions 0

Top hotspots

Path Status +/-
.claude/skills/retro-design/SKILL.md added +83 / -0
.claude/skills/retro-design/references/styles-index.md added +63 / -0
.claude/skills/retro-design/scripts/build-index.mjs added +49 / -0
README.md modified +12 / -0
.gitignore modified +3 / -0

Top directories

Directory Files Total changes
.claude/skills/retro-design 1 83
.claude/skills/retro-design/references 1 63
.claude/skills/retro-design/scripts 1 49
. 2 15
Analysis Depth Readiness (commit-history, 21%)

ECC Tools uses this to decide whether recommendations should stay at commit-history/setup guidance or expand into CI, security, harness, reference-set, AI-routing, and team backlog work.

Area Status Evidence / Next Step
Commit history Partial 2 commits sampled
CI/CD signals Missing Add workflow files or CI troubleshooting evidence so ECC Tools can reason about pipeline setup.
Security evidence Missing Add AgentShield, audit, SARIF, SBOM, or security review evidence so recommendations can cover security posture.
Harness configuration Ready .claude/skills/retro-design/SKILL.md, .claude/skills/retro-design/references/styles-index.md, .claude/skills/retro-design/scripts/build-index.mjs
Reference/eval evidence Missing Add fixtures, golden traces, reference sets, or evaluator benchmarks so deeper recommendations have regression evidence.
AI routing and cost controls Missing Add model-routing, budget, usage, or cost-control files before relying on AI-heavy automation recommendations.
Team handoff and project tracking Missing Add roadmap, runbook, project, Linear, or follow-up tracking docs so generated work can land in a team queue.
Reference Set Readiness (1/7, 14%)
Area Status Evidence / Next Step
Deep analyzer corpus Missing Add analyzer fixture, golden, benchmark, or reference-set files that can catch analyzer regressions.
RAG/evaluator comparison Missing Add retrieval or evaluator reference-set comparison fixtures with expected ranking behavior.
PR salvage/review corpus Missing Add stale-PR, review-thread, reopen-flow, or salvage reference cases for queue cleanup automation.
Discussion triage corpus Missing Add public discussion triage fixtures, golden cases, or reference sets for informational, answered, and no-response classifications.
Harness compatibility Present .claude/skills/retro-design/SKILL.md, .claude/skills/retro-design/references/styles-index.md, .claude/skills/retro-design/scripts/build-index.mjs
Security evidence Missing Attach security evidence such as SBOMs, SARIF, audit reports, or AgentShield evidence packs.
CI failure-mode evidence Missing Add captured CI failure logs, dry-run fixtures, or troubleshooting docs for common workflow failure modes.
Likely Future Issues (2)
Severity Signal Why it may show up
MEDIUM AI or harness analysis changes may ship without reference-set validation 3 reference-sensitive path(s) changed; 0 eval, golden trace, benchmark, or reference-set artifacts changed
MEDIUM Harness config changes may ship without compatibility evidence 3 harness config paths changed; 0 harness compatibility evidence artifacts changed
  • AI or harness analysis changes may ship without reference-set validation: The PR changes analyzer, skill, agent, command, or harness guidance without updating any obvious eval, golden trace, benchmark, or reference-set artifact.
  • Harness config changes may ship without compatibility evidence: The PR changes harness, MCP, plugin, or agent configuration without touching harness audit, adapter matrix, cross-harness docs, or compatibility regression evidence.
Suggested Follow-up Work (2)
Type Suggested title Targets
PR analysis: add reference-set evidence for .claude/skills/retro-design/SKILL.md + .claude/skills/retro-design/references/styles-index.md .claude/skills/retro-design/SKILL.md, .claude/skills/retro-design/references/styles-index.md
PR harness: add config quality evidence for .claude/skills/retro-design/SKILL.md + .claude/skills/retro-design/references/styles-index.md .claude/skills/retro-design/SKILL.md, .claude/skills/retro-design/references/styles-index.md
  • analysis: add reference-set evidence for .claude/skills/retro-design/SKILL.md + .claude/skills/retro-design/references/styles-index.md: Backfill eval, golden trace, benchmark, or reference-set evidence before another AI or harness-analysis change lands on the touched surface.
  • harness: add config quality evidence for .claude/skills/retro-design/SKILL.md + .claude/skills/retro-design/references/styles-index.md: Backfill harness audit, adapter matrix, or cross-harness compatibility evidence before another config change lands on the touched surface.

Copy-ready bodies

analysis: add reference-set evidence for .claude/skills/retro-design/SKILL.md + .claude/skills/retro-design/references/styles-index.md

## Summary
- Add reference-set or eval evidence for the recently changed AI, analyzer, skill, agent, command, or harness guidance surface.

## Why
- Backfill eval, golden trace, benchmark, or reference-set evidence before another AI or harness-analysis change lands on the touched surface.

## Touched paths
- `.claude/skills/retro-design/SKILL.md`
- `.claude/skills/retro-design/references/styles-index.md`

## Validation
- Add or update an eval, golden trace, benchmark, fixture, or reference-set artifact for the changed AI/harness behavior.
- Compare the changed behavior against the maintained reference set and record the pass/fail evidence.
- Confirm the follow-up evidence covers the same analyzer, skill, agent, command, or harness surface touched by this PR.

harness: add config quality evidence for .claude/skills/retro-design/SKILL.md + .claude/skills/retro-design/references/styles-index.md

## Summary
- Add harness compatibility evidence for the recently changed config surface.

## Why
- Backfill harness audit, adapter matrix, or cross-harness compatibility evidence before another config change lands on the touched surface.

## Touched paths
- `.claude/skills/retro-design/SKILL.md`
- `.claude/skills/retro-design/references/styles-index.md`

## Validation
- Run or update the harness audit, adapter compliance matrix, or cross-harness compatibility check for the changed config.
- Add or update a regression, fixture, or doc evidence path that covers the affected harness, MCP, plugin, or agent loading behavior.
Generated Instincts (15)
Domain Count
git 4
code-style 9
testing 2

After merging, import with:

/instinct-import .claude/homunculus/instincts/inherited/retro-design-system-instincts.yaml

Files

  • .claude/ecc-tools.json
  • .claude/skills/retro-design-system/SKILL.md
  • .agents/skills/retro-design-system/SKILL.md
  • .agents/skills/retro-design-system/agents/openai.yaml
  • .claude/identity.json
  • .codex/config.toml
  • .codex/AGENTS.md
  • .codex/agents/explorer.toml
  • .codex/agents/reviewer.toml
  • .codex/agents/docs-researcher.toml
  • .claude/homunculus/instincts/inherited/retro-design-system-instincts.yaml

ECC Tools | Everything Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant