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.

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

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

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"}