What problem does it solve? Publishing a local agent skill to GitHub involves many failure points: invalid SKILL.md YAML frontmatter, README files that read like internal notes, confusion between skill names and repository names, and no verification that the published skill can actually be discovered and installed via npx skills add. ## Core Features & Use Cases - Strict SKILL.md Validation: Parses YAML frontmatter with PyYAML to catch quote and colon errors before publishing, with fix suggestions using block scalars. - README Quality Gate: Generates a product-style README when missing and blocks publishing if placeholder content like TODO or your-org/your-repo remains. - End-to-End Publishing with Verification: Creates or updates the GitHub repository via gh CLI, pushes commits, runs npx skills add --list discovery checks, and performs a real install in a temporary directory to confirm SKILL.md lands on disk. - Use Case: You finished a local skill in ~/.agents/skills/my-skill and want to share it. Run the publish script to validate, push to GitHub, verify installability, and sync it to the standard ~/.agents/skills directory in one pass. ## Quick Start Publish my local skill to GitHub and verify it can be installed with npx skills add.
