README Sync

Purpose

Ensures that the ## Agent Skills section in the root README.md accurately reflects all available skills in skills/.

Workflow

1. •Identify Skills: Use Glob or find to locate all SKILL.md files in skills/ and .cursor/skills/.
2. •Extract Information: For each skill found, use uv run skills-ref read-properties <skill-directory> to get the name and description.
3. •Generate Markdown: Format the collected information as a sorted list of markdown items:
   • •Format: - **[name](relative/path/to/skill/)**: description
4. •Update README.md: Replace the content between <!-- START-SKILLS --> and <!-- END-SKILLS --> markers in the root README.md with the newly generated list.

Implementation Notes

• •The skills-ref tool is part of the project dependencies and can be run via uv run.
• •Always maintain alphabetical order of the skills in the README.md list.
• •Ensure the relative paths in the markdown links correctly point to the skill directories from the root.

Examples

Scenario: Updating README.md after adding a new skill

1. •Find all skills in the directory skills/.
2. •Get properties for each skill: uv run skills-ref read-properties skills/claude-code-cli.
3. •Update README.md within the <!-- START-SKILLS --> block.