agentsclimarketplace

Readme sync

Skill yu-iskw/github-project-skills/.cursor/skills/readme-sync

Specialized Agent Skills to automate GitHub workflows using the GitHub CLI

Install
npx -y skills add yu-iskw/github-project-skills --skill readme-sync

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Synchronizes the list of Agent Skills in the root README.md with the actual skills present in the codebase.

SKILL.md

2.0 KB, as published. Nobody here has run it

README Sync

Purpose

Ensures that the ## Agents and ## Agent Skills sections in the root README.md accurately reflect all available agents in agents/ and skills in skills/.

Workflow

  1. Identify Items:
    • Locate all agents: Files ending in .md in agents/ (excluding .gitkeep).
    • Locate all skills: Directories in skills/ containing a SKILL.md file.
  2. Extract Information:
    • For skills: Use uv run skills-ref read-properties <skill-directory> to get the name and description.
    • For agents: Read the YAML frontmatter directly from the .md file to extract name and description.
  3. Generate Markdown: Format the collected information as sorted lists:
    • Format: - **[name](relative/path/to/item)**: description
    • Note: For agents, the link should point to the .md file. For skills, the link should point to the directory.
  4. Update README.md:
    • Replace content between <!-- START-AGENTS --> and <!-- END-AGENTS --> with the agents list.
    • Replace content between <!-- START-SKILLS --> and <!-- END-SKILLS --> with the skills list.

Implementation Notes

  • The skills-ref tool is used for skills in skills/.
  • For agents in agents/, extract the name and description from the YAML frontmatter (lines between ---).
  • Always maintain alphabetical order of the items in each section.
  • Ensure the relative paths in the markdown links correctly point to the items from the root.
  • Do not include items from .cursor/skills/ or .cursor/agents/.

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.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.