repo-polish

Preparing a repository for release involves generating metadata files like CITATION.cff and LICENSE, scaffolding mkdocs documentation, and auditing public-facing quality. This Skill automates that workflow by orchestrating the repoindex CLI for deterministic tasks and leveraging AI for prose improvements.

To generate metadata files like CITATION.cff, .zenodo.json, and codemeta.json automatically, use an automation tool that reads project configuration. This Skill creates these essential files by reading pyproject.toml and orchestrating the repoindex CLI to ensure accurate repository metadata.

Setting up mkdocs documentation with GitHub Actions deployment requires scaffolding the site structure and configuring workflow files. This Skill automates documentation scaffolding by setting up mkdocs and managing the necessary GitHub Actions configurations for automated deployment.

Yes, you can batch audit multiple GitHub repositories for release readiness. This Skill is applicable to individual repositories or batch operations across collections, auditing repository completeness and generating consistent metadata files across all selected projects.

Yes, repoindex is required to generate repository metadata and documentation. This Skill orchestrates the repoindex CLI to handle deterministic tasks like metadata generation and documentation scaffolding, while leveraging AI separately for context-dependent prose and README improvements.

Updating GitHub repository topics and descriptions from pyproject.toml involves parsing the configuration file and applying the changes via the GitHub API. This Skill manages GitHub enhancement by automatically extracting data from pyproject.toml to update repository topics and descriptions.