AgentSkillsCN

generate-readme-table

为 README 生成一份包含所有技能及其详细说明的 Markdown 表格。运行时加上 --write 参数,即可直接更新 README.md 文件。

SKILL.md
--- frontmatter
name: generate-readme-table
description:
  Generate a markdown table of all skills and descriptions for the README. Run
  with --write to update README.md directly.

Generate README Skills Table

Generate a markdown table listing all skills in this repository with their descriptions.

Usage

Run the generator script:

bash
bun .claude/skills/generate-readme-table/scripts/generate-readme-table.ts

To update the README.md file directly:

bash
bun .claude/skills/generate-readme-table/scripts/generate-readme-table.ts --write

README Format

The README.md file must contain marker comments for the table to be inserted:

markdown
<!-- SKILLS-TABLE-START -->
<!-- SKILLS-TABLE-END -->

The script will replace everything between these markers with the generated table.

Output Format

The generated table has two columns:

SkillDescription
skill-nameWhat the skill does

Skills are sorted alphabetically by name.

Pre-commit Hook

A pre-commit hook script is provided to automatically regenerate the table when SKILL.md files change:

bash
.claude/skills/generate-readme-table/scripts/pre-commit-readme-table.sh

Install it in your git hooks directory or use with a hook manager like husky or lefthook.