Codex Skills

Personal multi-skill repository for reusable Codex workflows that are useful locally but not ready to publish as standalone packages.

Skills

• ci-release-readiness: debug CI failures, dependency-update fallout, and release readiness.
• code-review-maintenance: review code, triage review claims, normalize drift, and fix brittle paths.
• documentation-maintenance: maintain docs, TSDoc, TypeDoc, and Docusaurus sites.
• eslint-plugin-maintenance: bootstrap, audit, and maintain ESLint plugin repositories.
• github-actions-workflow-maintenance: create, review, edit, and harden GitHub Actions workflows.
• lint-cleanup: fix lint and ESLint diagnostics without weakening rules.
• mermaid-diagram-maintenance: create, edit, review, and dark-theme Mermaid diagrams.
• prettier-plugin-maintenance: bootstrap, audit, and maintain Prettier plugin repositories.
• release-publish-loop: push release candidates, watch CI, and publish verified releases.
• remark-plugin-maintenance: bootstrap, audit, and maintain remark and remark-lint plugins.
• stylelint-plugin-maintenance: bootstrap, audit, and maintain Stylelint plugin repositories.
• test-quality-maintenance: add, repair, and improve tests, coverage, e2e, and benchmarks.
• verify-oxlint-plugin-compatibility: verify, diagnose, test, and document Oxlint support in ESLint plugin repositories.
• vsicons-association-recommender: recommend vscode-icons associations for workspace files.
• workspace-continuation: continue active work, implement plans, and write handoffs.

Install Locally

npm run install:local

This installs all skills from this repo into the shared user skill location for supported agents.

Validate

npm run validate
npm run test:skills
npm run test:python
npm run format:check
npm run release:verify

npm run test:skills runs an explicit contract for every skill. The matrix covers routing terms, core workflow sections, owned references and scripts, generated invocation metadata, parseable local icons, coverage registration, and executable helper entry points. Adding or removing a skill without updating its contract fails the suite.

npm run test:python adds the deeper behavior and failure-path tests for every Python helper and enforces aggregate branch coverage. It also rejects Cobertura reports whose filenames cannot be mapped back to tracked helper files, so Codecov cannot silently accept an upload that it will later fail to process. Both layers run in CI through npm run release:verify.

This repo is intentionally private/local-first for now. Individual skills can be promoted to standalone package repositories later if they prove stable enough to publish.