| name | avotokyo-workflows |
| description | Use avotokyo/workflows reusable GitHub Actions for TypeScript/Vite+ projects. Use when wiring CI/CD, choosing check/test/release/coverage workflows, or referencing avotokyo/workflows actions. |
| metadata | {"author":"avotokyo","version":"2026.6.19","source":"https://github.com/avotokyo/workflows"} |
avotokyo/workflows
Reusable GitHub Actions for TypeScript / Vite+ (vp) projects.
Repo: avotokyo/workflows. Pin with @main or a release tag.
Important: Workflows go in .github/workflows/ (job-level uses:). Actions go in actions/ (step-level uses:). Default commands: vp check, vp run build, vp test.
Permissions: Reusable workflows cannot escalate GITHUB_TOKEN beyond what the caller job grants. Always set permissions on the calling job when the workflow needs elevated scopes (release, coverage, deploy-pages, etc.). See best-practices-usage.
Based on avotokyo/workflows, updated 2026-06-19.
Documentation
| Doc | Audience | Content |
|---|
| README | Humans | Quick install, recommended entry points, minimal CI / release examples |
| ARCHITECTURE | Humans | Directory layout, three-layer model, composition patterns |
| This skill | Agents | Full component inventory, inputs, permissions, patterns, extension guides |
Read one reference file below for the component you need. Do not load all references at once.
Full Component Inventory
Composite Workflows
Recommended entry points.
Atomic Workflows
Single-job workflows. Compose manually for finer control.
| Name | Workflow file | Description | Reference |
|---|
| Check | ci-check.yml | Lint/check on one OS | ci-check |
| Test | ci-test.yml | Matrix OS × Node test | ci-test |
| Coverage | ci-coverage.yml | Coverage test + Codecov | ci-coverage |
| Autofix | ci-autofix.yml | Auto-fix and commit | ci-autofix |
| Changelog | release-changelog.yml | GitHub Release changelog | release-changelog |
| Publish | release-publish.yml | Dispatch publish by type | release-publish |
| Publish NPM | release-publish-npm.yml | Build + npm Registry publish | release-publish-npm |
| Publish GitHub | release-publish-github.yml | Build + GitHub Packages publish | release-publish-github |
| Deploy Pages | deploy-pages.yml | Build + GitHub Pages deploy | deploy-pages |
Actions
Composite steps for custom jobs.
Best Practices
| Topic | Description | Reference |
|---|
| Usage | Permissions, paths, matrix format, CI + coverage, choosing a layer | best-practices-usage |
Quick Reference
jobs:
test:
uses: avotokyo/workflows/.github/workflows/unit-test.yml@main
steps:
- uses: avotokyo/workflows/actions/core/setup@main
