v2.25.1 - maintenance patch (Pattern S, resource index, em-dash-scar cleanup + CI guards)
The short version
v2.25.1 is a maintenance patch. It banks a backlog of untagged maintenance that landed on main after v2.25.0 under one versioned release, so consumers get a clean, release-noted snapshot. There is no skill behavior change and no published-URL change. The catalog stays 65 skills and 5 sub-agents.
What it banks:
- Documentation-site reorg (Pattern S) to the Product on Purpose family layout, with full family-standard conformance.
- A generated, CI-gated resource index (
docs/RESOURCES.md) that links every published page to its source, plus adocs/front door. - Root-document link repair after the relocation, plus an enforcing CI guard so root links cannot rot silently again.
- An em-dash-scar cleanup: residual
.scars from earlier em-dash sweeps swept to-across user-facing and internal prose, with new advisory and enforcing guards to keep them out. - Three site dependency bumps and a pre-tag validator parity fix.
What changed
Documentation site (Pattern S). The Astro Starlight project now lives entirely under site/; repo-root docs/ is governance and human documentation only. Reference content is produced by one zero-dependency Node generator (scripts/gen-site.mjs) replacing three Python generators; the published base path has a single source of truth with a regression test; Astro is pinned to the family-shared 6.4.2. Every page slug and the redirect map are preserved (route parity verified before and after).
Resource index. docs/RESOURCES.md is a generated, CI-gated catalog linking every published page to its source-of-truth file in the repo, with a hand-authored docs/README.md front door.
Link integrity. Root-document links left broken by the relocation were repaired (roughly 90 README links and several CHANGELOG links repointed to the deployed site and GitHub release-tag pages), and a new enforcing CI guard (scripts/check-root-doc-links.mjs) prevents regressions.
Em-dash-scar cleanup. Residual . scars from an earlier em-dash sweep were swept to - across user-facing prose and an internal-prose safe subset, with two guards added: an advisory scar guard (scripts/check-emdash-scars.mjs) and an enforcing --site-docs frontmatter-YAML lint.
Tooling and dependencies. Site dependency bumps (@astrojs/starlight 0.39.3, dompurify 3.4.7, astro-mermaid 2.0.2); and scripts/pre-tag-validate.ps1 reconciled with the bash bundle and CI (it had listed two retired validators as required and omitted check-skill-sample-coverage, so the PowerShell bundle could never pass on Windows). Surfaced by an external repository audit.
Do I need to do anything?
No. There is no behavior change, no new skill, and no published-URL change. Everything you already use behaves exactly as before.
Versioning: maintenance patch. SemVer tracks compatibility, not significance: this release adds no capability and removes nothing. No new skills (catalog stays 65; sub-agents stay 5).
Full changelog: CHANGELOG.md - Release notes page: Release_v2.25.1
What's Included
- PM skills library (flat
skills/{phase-skill}/+ foundation capabilities) - Sample output library (
library/skill-output-samples/with README and canonical sample corpus) - Slash commands (10
/workflow-*orchestrators; every skill invocable by name) - Workflows (Triple Diamond, Lean Startup, Feature Kickoff)
- Claude plugin manifest (
.claude-plugin/plugin.json) - Claude/openskills discovery via sync helper (
scripts/sync-claude.sh/.ps1) - Docs: README, QUICKSTART, AGENTS, reference guides
Download
pm-skills-v2.25.1.zip - Complete package for all platforms
Installation
Claude Code / openskills
- Download
pm-skills-v2.25.1.zip - Extract, then run:
- Bash:
./scripts/sync-claude.sh - PowerShell:
./scripts/sync-claude.ps1
- Bash:
- Claude Code / openskills will discover commands in
.claude/commands/and skills in.claude/skills/.
Claude plugin clients
- Download
pm-skills-v2.25.1.zip - Extract the archive.
- Point plugin setup to
.claude-plugin/plugin.jsonfrom the extracted package.
Other editors/agents
- Use
skills/andcommands/directly from the extracted ZIP.
Quick Usage
/pm-skills:deliver-prd "Your feature description"
/pm-skills:define-hypothesis "Your assumption to test"
/workflow-feature-kickoff "Feature name"
See QUICKSTART.md in the archive for full instructions.