v1.3.1 - Public Safety And Launch Polish

v1.3.1 - Public Safety And Launch Polish

v1.3.1 is a patch release focused on public launch readiness. It tightens public-safety validation, replaces the heavy demo embed with lightweight video assets, refreshes social preview material, and documents dependency governance for the site tooling.

Highlights

• Removed hard-coded private markers from the public validator source.
• Added WORKFLOW_SKILL_ROUTER_PUBLIC_FORBIDDEN_MARKERS for local or private CI marker injection.
• Made public-readiness scan the validator source itself.
• Added a standard-library Markdown/MDX local link checker and wired it into CI.
• Replaced the showcase GIF embed with MP4/WebM video plus poster and GIF fallback.
• Added regenerated social preview images for the site and GitHub repository settings.
• Added launch copy for GitHub Discussions, Dev.to, Reddit, and Hacker News.
• Added dependency governance notes for the Lighthouse dev-tooling audit advisory.

Validation

Expected release gate:

python scripts/validate-router.py --self-test
python scripts/validate-router.py starter/workflow-skill-router
python scripts/validate-router.py examples/template-skill-catalog
python scripts/validate-router.py --public-readiness .
python scripts/audit-public-readiness.py .
python scripts/check-markdown-links.py .
python scripts/scan-skills.py ./sample-skills --fail-on-private --fail-on-duplicates
python scripts/evaluate-routing.py --scenarios evaluation/scenarios.example.jsonl --predictions evaluation/predictions.example.jsonl --report /tmp/routing-report-v1.3.1.md --json-report /tmp/routing-report-v1.3.1.json --fail-on-violations --strict
python scripts/validate-route-cases.py route-cases
python scripts/build-route-gallery.py --check
python scripts/render-routing-metrics-trend.py --check
python -m unittest discover -s tests
python scripts/smoke-release-assets.py --downloads-dir downloads --work-dir /tmp/wsr-release-smoke-v1.3.1
cd site
npm ci
npm run assets:demo:check
npm run assets:social:check
npm run build
npm run test:site:smoke
npm run test:site:visual
npm run audit:lighthouse
npm audit --omit=dev --audit-level=moderate

Release Assets

This release keeps the existing tracked download archives:

• workflow-skill-router-blank.zip
• workflow-skill-router-template-clean.zip
• workflow-skill-router-template.zip
• workflow-skill-router-template-manifest.md

No routing behavior or release packaging contract changes are included.

Notes

• Full dev npm audit may still report the monitored Lighthouse/Sentry/OpenTelemetry advisory. See docs/dependency-governance.md.
• The GitHub repository social preview should be manually updated with docs/assets/workflow-skill-router-social-preview.png after merge.

v1.3.0 - Community Gallery, Metrics, And Visual QA

v1.3.0 - Community Gallery, Metrics, And Visual QA

v1.3.0 moves Workflow Skill Router from a useful starter toward a more mature open-source project surface: public route cases, measurable routing quality, visual site checks, and privacy-first conversion tracking.

Highlights

• Added a public-safe Routing Gallery generated from root-level route-cases/*.json.
• Added route case validation, gallery data generation, and generated evaluator scenarios.
• Expanded the benchmark from 30 to 80 scenarios, including simple-task and anti-over-routing boundaries.
• Added release-level metrics history from v1.2.0 to v1.3.0.
• Added a Metrics Trends documentation page.
• Added Playwright smoke tests and key visual snapshots for home, downloads, gallery, and metrics pages.
• Added disabled-by-default Plausible-compatible analytics and transparent README CTA landing pages.
• Added route case submission guidance, issue template, and monthly release cadence docs.

Public Interfaces

• New route case schema: route-cases/*.json.
• New generated gallery data: site/src/data/route-cases.generated.json.
• New generated route-case scenarios: evaluation/route-cases.generated.jsonl.
• New metrics history: evaluation/metrics-history.jsonl.
• New site npm scripts:
  • npm run test:site:smoke
  • npm run test:site:visual
  • npm run test:site:update-snapshots
• New analytics env vars:
  • PUBLIC_ANALYTICS_PROVIDER
  • PUBLIC_PLAUSIBLE_DOMAIN
  • PUBLIC_PLAUSIBLE_SCRIPT_URL

Validation

Expected release gate:

python scripts/validate-router.py starter/workflow-skill-router
python scripts/validate-router.py examples/template-skill-catalog
python scripts/audit-public-readiness.py .
python scripts/scan-skills.py ./sample-skills --fail-on-private --fail-on-duplicates
python scripts/evaluate-routing.py --scenarios evaluation/scenarios.example.jsonl --predictions evaluation/predictions.example.jsonl --report /tmp/routing-report-v1.3.0.md --json-report /tmp/routing-report-v1.3.0.json --fail-on-violations --strict
python scripts/validate-route-cases.py route-cases
python scripts/build-route-gallery.py --check
python scripts/render-routing-metrics-trend.py --check
python -m unittest discover -s tests
python scripts/smoke-release-assets.py --downloads-dir downloads --work-dir /tmp/wsr-release-smoke-v1.3.0
cd site
npm ci
npm run build
npm run test:site:smoke
npm run test:site:visual
npm run audit:lighthouse

Release Assets

This release keeps the existing tracked download assets and verifies them with the release asset smoke test:

• workflow-skill-router-blank.zip
• workflow-skill-router-template-clean.zip
• workflow-skill-router-template.zip
• workflow-skill-router-template-manifest.md

No routing behavior or release packaging contract changes are included.

v1.2.0 - Onboarding And Adapter Notes

v1.2.0 - Onboarding And Adapter Notes

Workflow Skill Router v1.2.0 focuses on public onboarding quality: a clearer Blank Router path, practical troubleshooting, adapter notes for other AI coding tools, and a shareable 60-second demo.

Highlights

• Added a complete Blank Router walkthrough that starts from the downloadable blank package and ends with validated route examples.
• Added Troubleshooting coverage for install paths, PowerShell, Python, zip extraction, validator messages, and public-readiness checks.
• Added Claude, Cursor, and Gemini adapter notes that explain how to reuse the routing contract outside Codex without claiming fixed product UI paths.
• Added a 60-second demo GIF showing fuzzy request intake, route selection, validation, and the download path.
• Updated README, Quickstart, Showcase, and the documentation sidebar so new visitors can find the next step quickly.

Validation

python scripts/validate-router.py starter/workflow-skill-router
python scripts/validate-router.py examples/template-skill-catalog
python scripts/audit-public-readiness.py .
python scripts/scan-skills.py ./sample-skills --fail-on-private --fail-on-duplicates
python scripts/evaluate-routing.py --scenarios evaluation/scenarios.example.jsonl --predictions evaluation/predictions.example.jsonl --report /tmp/routing-report.md --json-report /tmp/routing-report.json --fail-on-violations --strict
python -m unittest discover -s tests
python scripts/smoke-release-assets.py --downloads-dir downloads --work-dir /tmp/wsr-release-smoke-v1.2.0
cd site && npm ci && npm run build

Download Assets

This release continues to use the current public download assets:

• workflow-skill-router-blank.zip: installable blank starter.
• workflow-skill-router-template-clean.zip: clean installable reference package.
• workflow-skill-router-template.zip: full public-safe reference package.
• workflow-skill-router-template-manifest.md: package manifest and sanitization summary.

v1.1.2 — Public Minimum Release Sync

v1.1.2 - Public Minimum Release Sync

Workflow Skill Router v1.1.2 is a small public-readiness patch that syncs the latest main branch with a fresh release and makes the public release checks easier to trust.

Highlights

• Synced the patch release with the latest README, download, and site copy on main.
• Added a README package selector so new visitors can choose Blank Router, Reference Template, or Full source archive without guessing.
• Added release asset smoke testing for the downloadable zip packages and manifest.
• Added the documentation site build to the main validation workflow.
• Documented the v1.1.1 public launch polish in the changelog.

Validation

python scripts/validate-router.py starter/workflow-skill-router
python scripts/validate-router.py examples/template-skill-catalog
python scripts/audit-public-readiness.py .
python scripts/scan-skills.py ./sample-skills --fail-on-private --fail-on-duplicates
python scripts/evaluate-routing.py --scenarios evaluation/scenarios.example.jsonl --predictions evaluation/predictions.example.jsonl --report /tmp/routing-report.md --json-report /tmp/routing-report.json --fail-on-violations --strict
python -m unittest discover -s tests
python scripts/smoke-release-assets.py --downloads-dir downloads --work-dir /tmp/wsr-release-smoke-v1.1.2
cd site && npm ci && npm run build

Download Assets

• workflow-skill-router-blank.zip: installable blank starter.
• workflow-skill-router-template-clean.zip: cleaner installable reference package.
• workflow-skill-router-template.zip: full public-safe reference package.
• workflow-skill-router-template-manifest.md: package manifest and sanitization summary.

v1.1.1 — Public Launch Polish and Professional Open-Source Tone

v1.1.1 — Public Launch Polish and Professional Open-Source Tone

Workflow Skill Router v1.1.1 focuses on public launch readiness: clearer onboarding, stronger shareable examples, a more professional open-source tone, and refreshed site dependencies.

Highlights

• Refined README and site calls to action to emphasize the open-source project, releases, downloads, and reusable routing pattern instead of active star requests.
• Added public launch showcase material, including fuzzy-request-to-route-output demo assets, showcase cases, case studies, anti-over-routing guidance, and forward-test records.
• Added a clean installable template package alongside the blank package and full reference package.
• Completed sample skill metadata coverage so scanner warnings are clean for the public sample catalog.
• Updated Astro from 6.4.6 to 6.4.7 for the documentation site.

Validation

Latest main checks passed:

Validate router tools: success
Deploy Starlight site to GitHub Pages: success
Public HTTPS smoke test: success

Local validation used during launch polish:

python scripts/validate-router.py starter/workflow-skill-router
python scripts/validate-router.py examples/template-skill-catalog
python scripts/audit-public-readiness.py .
python scripts/scan-skills.py ./sample-skills --fail-on-private --fail-on-duplicates
python scripts/evaluate-routing.py --scenarios evaluation/scenarios.example.jsonl --predictions evaluation/predictions.example.jsonl --fail-on-violations --strict
python -m unittest discover -s tests
cd site && npm run audit:lighthouse

Useful Links

• Quickstart: https://huangchiyu.com/Workflow-skill-router/guides/quickstart/
• Downloads: https://huangchiyu.com/Workflow-skill-router/guides/downloads/
• Showcase: https://huangchiyu.com/Workflow-skill-router/showcase/
• Case studies: https://huangchiyu.com/Workflow-skill-router/examples/case-studies/

Download Assets

• workflow-skill-router-blank.zip: installable blank starter.
• workflow-skill-router-template.zip: full public-safe reference package.
• workflow-skill-router-template-clean.zip: cleaner installable reference package.
• workflow-skill-router-template-manifest.md: package manifest and sanitization summary.

v1.1.0 — Routing Evaluation, Skill Inventory Scanner, and CI Quality Gates

v1.1.0 — Routing Evaluation, Skill Inventory Scanner, and CI Quality Gates

Workflow Skill Router v1.1.0 adds repeatable quality checks around skill routing. This release turns the project from a starter/template package into a small, dependency-free framework for inventorying skills, evaluating routing decisions, and validating changes in CI.

Highlights

• Added routing evaluation framework with JSONL scenarios and predictions.
• Added 30 example routing scenarios and a generated example report.
• Added dependency-free skill inventory scanner.
• Added generated skill index, scan warnings, and suggested skill tree examples.
• Added unit tests for the evaluator and scanner.
• Added GitHub Actions validation workflow.
• Updated README, docs, routing metrics guide, evaluation guide, scanner guide, and site proof messaging.

Validation

Run:

python scripts/validate-router.py starter/workflow-skill-router
python scripts/validate-router.py examples/template-skill-catalog
python scripts/audit-public-readiness.py .

python scripts/scan-skills.py ./sample-skills \
  --out /tmp/skill-index.json \
  --markdown /tmp/skill-index.md \
  --warnings /tmp/skill-warnings.md \
  --suggest-tree /tmp/suggested-skill-tree.md \
  --fail-on-private \
  --fail-on-duplicates

python scripts/evaluate-routing.py \
  --scenarios evaluation/scenarios.example.jsonl \
  --predictions evaluation/predictions.example.jsonl \
  --report /tmp/routing-report.md \
  --json-report /tmp/routing-report.json \
  --fail-on-violations \
  --strict

python -m unittest discover -s tests

Expected:

OK: workflow-skill-router passed validation
OK: template-skill-catalog passed validation
OK: public-readiness audit passed
19 tests pass

Positioning Notes

This release ships with 30 example routing scenarios, a dependency-free skill inventory scanner, a routing evaluation harness, and CI quality gates for validation, scanning, evaluation, and unit tests.

It is designed for explainable, bounded, public-safe workflow skill routing. The example benchmark is a starting point for teams to adapt, not a claim that every router or catalog will score perfectly in production.

Workflow Skill Router v1.0.0

v1.0.0 Release Notes

Workflow Skill Router v1.0.0 packages the project as a public AI Agent skill routing pattern.

Highlights

• Agent-agnostic routing model with a Codex-ready starter.
• Dependency-free validator for router packages.
• Blank starter and full template skill catalog downloads.
• Single Template Skill Catalog example aligned with the downloadable template package.
• Public-safe sample skill package for common engineering, frontend, backend, testing, documentation, DevOps, and product workflows.
• Copyable routing catalog showing how real multi-skill routes are composed.
• Practical recipes for common routing scenarios.
• Customization guidance for adapting the starter router.
• GitHub issue and PR templates for routing failures and example requests.
• English and Traditional Chinese documentation site.

Validation

Run:

python scripts/validate-router.py starter/workflow-skill-router
python scripts/validate-router.py examples/template-skill-catalog

Expected:

OK: workflow-skill-router passed validation
OK: template-skill-catalog passed validation