Menu
Generate CATALOG.md from deployed tickets. Extracts files_created metadata and builds project asset catalog with usage instructions.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Merges bookend agent reports into revised readiness, complexity, and decomposition plan. Produces the final evidence-backed assessment consumed by sprint-architect-agent.
Fast filesystem readiness scan — counts docs, source files, manifests, platform signals. Produces initial ReadinessReport for agent spawning decisions.
Scores proposal complexity against codebase surface. Uses proposal text analysis and readiness stats to determine decomposition tier and agent count.
Generation-time design taste for web UI work. Anti-cliche bans, layout and motion hard rules, and client-intent dials. Advisory only - shapes drafts; declared measured contracts remain the sole gate authority.
Rigorously reasons about definitions, proofs, and computations in algebra, analysis, discrete math, probability, linear algebra, and applied math. Verifies derivations, spots invalid steps, and states assumptions clearly. Use when solving or proving math problems, reviewing mathematical arguments, modeling with equations, interpreting statistics, or when the user mentions proofs, lemmas, theorems, integrals, series, matrices, optimization, or numerical methods.
Visual verification for interactive elements (popups, modals, tooltips). Clicks elements and captures screenshots for analysis. Bypasses MCP browser tool limitations with cross-origin CSS.
| name | generate-catalog |
| description | Generate CATALOG.md from deployed tickets. Extracts files_created metadata and builds project asset catalog with usage instructions. |
Generates or updates CATALOG.md from deployed ticket metadata. Builds a comprehensive asset catalog showing all components, styles, and utilities with usage instructions.
{
"project_dir": "/path/to/project",
"tickets_dir": "/path/to/tickets/deployed",
"include_tests": false,
"include_deps": true
}
cd $tickets_dir
for ticket in *.json; do
jq -r '.files_created[]' "$ticket"
done
For each deployed ticket, extract:
{
"files_created": [
{
"path": "src/components/MetricCard.js",
"type": "component",
"intended_use": "Import { MetricCard } from './MetricCard.js'"
}
]
}
| Category | Patterns | Description |
|---|---|---|
| Components | src/components/**/*.js | Reusable UI components |
| Styles | src/styles/**/*.css | CSS stylesheets |
| Utils | src/utils/**/*.js, src/js/utils/** | Helper functions |
| Data | src/data/**/*.json | Static data files |
| Pages | src/pages/**/*.html | HTML pages |
| Tests | tests/**/*, *.spec.js | Test files (if included) |
# Project Asset Catalog
> Auto-generated by generate-catalog on {date}
## Summary
| Category | Count | Status |
|----------|-------|--------|
| Components | 5 | ✅ |
| Styles | 3 | ✅ |
## Components
| File | Intended Use | Created By |
|------|--------------|------------|
| `src/components/MetricCard.js` | Import { MetricCard } | TICKET-001 |
{
"skill": "generate-catalog",
"status": "success|failure",
"catalog_path": "src/CATALOG.md",
"stats": {
"tickets_processed": 5,
"files_cataloged": 23,
"categories": {
"components": 8,
"styles": 5,
"utils": 4,
"data": 2,
"pages": 4
}
},
"errors": [],
"warnings": [],
"next_action": "proceed"
}
# Project Asset Catalog
> Auto-generated by generate-catalog on 2026-01-07
## Summary
| Category | Count | Status |
|----------|-------|--------|
| Components | 8 | ✅ |
| Styles | 5 | ✅ |
| Utils | 4 | ✅ |
| Data | 2 | ✅ |
| **Total** | **19** | |
## Components
| File | Intended Use | Created By |
|------|--------------|------------|
| `src/components/impact/MetricCard.js` | Import { MetricCard } from './MetricCard.js' | TICKET-OXY-003-A.3 |
## Styles
| File | Intended Use | Created By |
|------|--------------|------------|
| `src/styles/components/metric-card.css` | Link in HTML: <link rel="stylesheet" href="..."> | TICKET-OXY-003-A.3 |
## Changelog
- **2026-01-07**: Added MetricCard component via TICKET-OXY-003-A.3
All tickets parsed successfully?
YES → status: "success"
NO → status: "failure", errors: [parse errors]
Catalog written successfully?
YES → next_action: "proceed"
NO → next_action: "fix"
Generate from deployed tickets:
{
"project_dir": "/projects/oxygen_site",
"tickets_dir": "/projects/oxygen_site/tickets/sprint_current/deployed",
"include_tests": false,
"include_deps": true
}
Include test files:
{
"project_dir": "/projects/oxygen_site",
"tickets_dir": "/projects/oxygen_site/tickets/sprint_current/deployed",
"include_tests": true,
"include_deps": true
}
Custom tickets directory:
{
"project_dir": "/projects/oxygen_site",
"tickets_dir": "/projects/oxygen_site/tickets/archive/sprint-42",
"include_tests": false,
"include_deps": false
}
When updating existing CATALOG.md: