القائمة
Export a CSV inventory of all documentation pages (title, navigation path levels, and public URL) from the frontmatter of every Markdown file under src/content
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Understand and maintain how the CRD reference pages under /reference/platform-api/crd/ are generated — register a new CRD source repo, make sure every published CRD has an example CR, and fix pages that render without an example
Classify documentation pages into their Diátaxis type and propose the diataxis_content_type frontmatter value, flagging pages that mix modes
Create a box on a Miro board for every row in a CSV inventory of pages (e.g. the output of the export-csv skill) — each box shows the page title as a clickable link to its URL, with the navigation path as a subline
Assess English readability of documentation pages (Flesch Reading Ease, Flesch-Kincaid grade, Gunning Fog, LIX), excluding generated content
Apply style fixes and run Vale prose linting on modified or added pages
Find documentation pages that need style improvements (long paragraphs, non-sentence-case headings, over-long shell code lines, and Vale findings)
| name | export-csv |
| description | Export a CSV inventory of all documentation pages (title, navigation path levels, and public URL) from the frontmatter of every Markdown file under src/content |
| user-invocable | true |
Generate a flat CSV listing every documentation page, so the content can be reviewed, filtered, or analyzed in a spreadsheet.
A helper script does the work in code — don't assemble the inventory by hand.
A CSV file (export.csv by default) with one row per page and these columns:
title — from the page's frontmatterdiataxis_content_type — the page's Diátaxis type (tutorial, how-to-guide,
reference, explanation, or none); empty for list pages and untagged pagespath_l1 through path_l6 — the first six URL path segments, i.e. the
navigation hierarchyurl — the public docs URL (https://docs.giantswarm.io/<relpath>)The script walks all .md files under src/content, reads each file's YAML
frontmatter, and derives the path levels and URL from the file location.
By default it excludes the /changes/ section (changelogs, path_l1=changes),
which otherwise dominates the output. Adjust EXCLUDED_SECTIONS in the script to
change which top-level sections are skipped.
Run the script (pure Python plus PyYAML, no Docker needed):
python3 .claude/skills/export-csv/export_csv.py
It writes export.csv to the current working directory and covers all
pages under src/content.
Report the result to the user — the output path and how many rows were written. Offer to open or summarize the CSV if useful.
make export-csv target, which runs it inside
the docs-scriptrunner Docker image (no local Python required).