$ show rmyndharis/antigravity-skills
This repository is a comprehensive skill manager for AI agents, providing a CLI tool (Node.js and Python) to search, install, list, and update a large library of over 300 skill definitions. The skills are structured markdown files with YAML frontmatter, each defining a specific capability or workflow for an AI assistant (e.g., code review, security audit, database optimization, TDD orchestration). The application includes a catalog generation pipeline, validation scripts with baseline support, and CI checks to ensure skill quality and consistency. While the bulk of the repository is composed of skill content (instruction playbooks), the active software layerβthe CLI, catalog builder, and validatorβrepresents a well-engineered dual-language application with tests and automation.
The LLM identified 6 files worth highlighting for reuse:
Single source of truth for the allowed frontmatter fields, field order, line limits, and name patterns for all skills. Demonstrates the pattern of defining a content schema in one module and using it across validation and catalog generation. Reusable for any content registry that requires strict metadata constraints.
Provides core utilities: listSkillIds, readSkill, parseFrontmatter, tokenize, unique. The parseFrontmatter function includes YAML error recovery and handles edge cases robustly. This module is cleanly decoupled from the CLI and could be extracted into a separate npm package for parsing structured markdown with frontmatter.
A standalone script that normalizes frontmatter fields across skill files: deduplicates fields and merges conflicting values. Follows an idempotent, well-documented pattern useful for any project that needs to enforce consistency in YAML frontmatter across many files.
Generates multiple catalog artifacts (catalog.json, CATALOG.md, bundles.json, aliases.json) from the skill file tree. Implements category detection via keyword rules, tag derivation with stopword filtering, alias shortening, and bundle matching. The logic is importable (computeArtifacts function) and showcases a pattern for building a searchable registry from a flat file structure.
Validates all skills against the schema defined in skill-schema.js. Supports a strict mode with baseline grandfathering of known soft violations, requiring explicit --yes to update the baseline. This pattern is reusable for any content review process where existing issues are tracked and only new violations are enforced.
A standalone Python CLI implementation that mirrors the Node CLI's functionality using only the Python standard library. Implements GitHub API folder recursion for installing all skills, safe path resolution with contained_join to prevent path traversal, and sanitizes skill IDs. Demonstrates a portable, dependency-free approach to building a CLI that interacts with GitHub raw content.