avotokyo-workflows

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.

Name	Workflow file	Description	Reference
Unit Test	unit-test.yml	Check + matrix test CI	composite-unit-test
Release	release.yml	Changelog + publish by type	composite-release

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.

Name	Path	Description	Reference
Setup	actions/core/setup	Checkout + Vite+ environment	core-setup
Run	actions/core/run	Execute a shell command	core-run
Changelog	actions/release/changelog	Run changelogithub (step)	release-changelog
Publish	actions/release/publish	vp pm publish by type	release-publish
Upload Codecov	actions/integrations/upload-codecov	Codecov OIDC upload	integrations-upload-codecov
Autofix Commit	actions/integrations/autofix-commit	autofix-ci commit	integrations-autofix-commit

Best Practices

Topic	Description	Reference
Usage	Permissions, paths, matrix format, CI + coverage, choosing a layer	best-practices-usage

Quick Reference

# Workflow — under jobs
jobs:
  test:
    uses: avotokyo/workflows/.github/workflows/unit-test.yml@main

# Action — under steps
steps:
  - uses: avotokyo/workflows/actions/core/setup@main