The check-generated CI step was failing with "web/skills.json is stale" because build-skills.mjs stamped a wall-clock generatedAt into the file, so every rebuild differed and git diff --exit-code never matched. - web/build-skills.mjs: drop the unused generatedAt timestamp -> deterministic output the CI staleness check can verify. Also tags each skill with its tier. - skill-tiers.json: single machine-readable source for tier membership (Production-Ready / Experimental); TIERS.md points to it. Playground upgrades (hosted on GitHub Pages): - Tier filter (Production-Ready / Stable / Experimental) + per-tile tier badges. - "Use this skill in another tool" panel: copy the instructions formatted for ChatGPT, Gemini, or raw — mirrors the generated exports/ files. - web/README documents the new options and the deterministic build. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016JWn5jRD5tcEFKrubjQ6Px
4.1 KiB
Skill Tiers
Not every skill in a 170+ library is at the same level of maturity — and pretending otherwise wastes your time. This page tiers the skills honestly so you can start with the strongest work and know what to expect from the rest.
| Tier | What it means |
|---|---|
| 🟢 Production-Ready | Battle-tested, stable output format, used in real work. Includes the skills with computed helper scripts. Start here. |
| 🔵 Stable | Solid and well-structured. Reliable output; smaller track record than Production-Ready. This is the default tier for most of the library. |
| 🟡 Experimental | Newer, niche, or dependent on an external tool/API/scrape (Gemini, Gmail, browser automation, social scraping). Useful, but more setup and more moving parts — expect rough edges. |
⚙️ = ships a stdlib-only Python helper script that computes part of the work.
🟢 Production-Ready (46)
These are the skills to reach for first — the most-used, most-refined frameworks in the library.
Product core
prd-template · meeting-notes · stakeholder-update · user-research-synthesis · competitive-analysis
Prioritisation & planning
rice-prioritisation ⚙️ · feature-prioritisation · okr-builder · roadmap-narrative · rice-impact-matrix
Delivery
sprint-planning ⚙️ · sprint-brief · user-story-writer · retro-analysis · ab-test-planner · product-launch-checklist · technical-spec-template
Discovery
customer-journey-map · assumption-mapper · user-interview-synthesis · discovery-interview-guide · job-story-mapper
Data & analytics
data-analysis-standard · retention-analysis · cohort-analysis · metrics-framework · product-health-analysis
Customer success
cs-health-scorecard ⚙️ · churn-analysis · qbr-deck · renewal-playbook · customer-success-plan · cs-escalation-brief
Engineering
code-review-checklist · incident-postmortem · architecture-decision-record · api-docs-writer · runbook-writer · changelog-generator · pr-description-writer · technical-debt-register
GTM & strategy
go-to-market · competitor-teardown · product-positioning-doc
Cross-profession
executive-summary · press-release
🟡 Experimental
These depend on external services, scraping, or browser/desktop automation. They can be genuinely useful, but they have more setup and more failure modes than a self-contained markdown skill — treat output as a strong draft, and expect to adapt them to your environment.
| Skill | Why it's experimental |
|---|---|
instagram-post-downloader |
Depends on Instagram's page structure; can break when the site changes. |
substack-notes-scraper |
Scrapes Substack engagement data; fragile to layout changes. |
thumbnail-creator |
Requires a Gemini API key and image generation. |
notebooklm-connector |
Drives NotebookLM via a Chrome extension / browser automation. |
email-triage |
Requires Gmail access and a configured time window. |
morning-intelligence |
Designed for scheduled-task / routine setups; depends on your news sources. |
last-30-days-research |
Relies on live Reddit / X / web search availability and quality. |
competitor-signal-tracker |
Depends on the live sources you point it at. |
multi-source-signal-synthesiser |
Quality depends on the breadth/quality of sources supplied. |
🔵 Stable (everything else)
Every skill not listed above is Stable: well-structured, reliable output, broadly useful — just with a shorter track record than the Production-Ready set. Browse the full list in the README.
Tiers are reviewed as skills mature. New skills enter as Experimental and are promoted once they have a stable output format and real-world use — see SKILL-AUTHORING-STANDARD.md. Think a skill is mis-tiered? Open an issue.
For tooling: the machine-readable tier membership lives in
skill-tiers.json(the Skill Playground reads it to badge and filter skills). Keep this page and that file in sync when re-tiering.