royalpinto007
UserAgent Skills that make a repo shippable: tests, CI, packaging, release, and repo hygiene. The build-side counterpart to distro-skills.
Categories
Indexed Skills (16)
add-tests
When a repo has no tests or thin coverage and the user wants a real test setup. Triggers: 'add tests', 'set up testing', 'no tests', 'test coverage'. Scaffolds the right test runner for the stack and writes first meaningful tests.
cut-a-release
When the user wants to ship a version. Triggers: 'cut a release', 'publish a version', 'tag a release', 'release it'. Bumps the version with semver, tags, writes release notes, and publishes to the registry.
env-and-config
When a project needs configuration or risks leaking secrets. Triggers: 'env variables', 'config', '.env.example', 'keep secrets out', 'twelve-factor'. Documents config, adds an env example, and keeps real secrets out of the repo.
license-and-legal
When a repo has no license or unclear terms. Triggers: 'add a license', 'which license', 'license and legal', 'can people use this'. Helps pick and add the right license plus any third-party notices.
lint-and-format
When a repo has inconsistent style or no linter or formatter. Triggers: 'add linting', 'set up prettier/eslint/ruff', 'format the code', 'style config'. Adds the standard linter and formatter for the stack with config and a check.
one-command-run
When trying a project takes too many steps. Triggers: 'one command to run', 'quickstart', 'cold start', 'make it easy to try', 'npx/pipx/docker run'. Makes the project runnable in one command and verifies the stranger path.
package-for-npm
When a Node project should be publishable to npm. Triggers: 'publish to npm', 'make it an npm package', 'npx-runnable', 'package.json for publish'. Prepares package.json and metadata so the package installs, runs, and publishes cleanly.
package-for-pypi
When a Python project should be publishable to PyPI. Triggers: 'publish to PyPI', 'make it a pip package', 'pyproject for publish', 'pipx-runnable'. Prepares pyproject.toml and metadata so the package builds, installs, and publishes cleanly.
readme-that-converts
When a repo's README does not sell or explain the project in its first screen. Triggers: 'improve the README', 'README as landing page', 'my readme is weak', 'readme that converts'. Rewrites the top of the README to say what, why, and how fast, with badges and a demo slot.
repo-hygiene-pass
When a repo is missing the standard github-ready files. Triggers: 'repo hygiene', 'add contributing/license/templates', 'make it github-ready', 'issue and PR templates'. Adds LICENSE, CONTRIBUTING, code of conduct, issue and PR templates, gitignore, and editorconfig.
security-basics
When a repo is about to be public or the user wants baseline security. Triggers: 'security', 'SECURITY.md', 'dependabot', 'am I leaking secrets', 'security basics'. Adds a disclosure policy, dependency and secret scanning, and checks nothing sensitive is committed.
set-up-ci
When a repo has no CI or the user wants tests to run automatically. Triggers: 'set up CI', 'add GitHub Actions', 'run tests on PR', 'CI badge'. Adds a CI workflow that runs tests and lint on every push and PR, with a status badge.
ship-checklist
When the user wants to know what is left before a repo is shippable, or wants the ship sequence. Triggers: 'is this ready to ship', 'ship checklist', 'what is missing before release'. Audits the repo against a shippable bar and sequences the other ship-skills.
ship-context
When starting to make a repo shippable, or before any other ship-skill. Triggers: 'ship this', 'make it production ready', 'prepare to release', 'ship-context'. Detects the repo's stack and records it in .agents/ship.md so every other ship-skill reuses it.
write-a-changelog
When a repo has no changelog or an outdated one. Triggers: 'add a changelog', 'CHANGELOG.md', 'keep a changelog', 'release notes'. Adds a Keep a Changelog file and keeps an Unreleased section current.
markdown-formatter
Formats markdown files to a consistent style
Bio shown is the top-scored skill's repo description as a fallback — real GitHub bios land in a future update.