0.5

What's new in 0.5

Self-updating skills

• Every skill's pre-flight update check is now consent-gated self-install. When a skill detects it's behind the manifest, it offers to update itself — on agreement, it downloads the .skill from the latest release and unpacks it over the installed skill directory. The unpack path is resolved from where the running skill lives, so this works for any agent whose skills directory is writable, not just Claude Code.
• All skills bumped a minor to carry the new flow: astro-seo → 0.6, readability-check → 0.5, the rest → 0.4.

Astro SEO skill

• Updated for @jdevalk/astro-seo-graph 1.1.1 and 1.2.0.
• 1.1.1 bug fixes folded in. validateInternalLinks now recognises public/ assets as valid link targets (the skip callback trims back to just SSR-only routes and dynamic params), and validateMetadataLength no longer truncates descriptions at raw apostrophes — both workarounds removed.
• 1.2.0 markdown alternates. New Should in category 6 (agent discovery): serve clean .md copies of every page for AI agents. Integration example enables markdownAlternate: true (gated on wiring the route first), and a new Phase 2 subsection covers createMarkdownEndpoint, route-before-discovery-link ordering, Cloudflare Transform Rules for Accept: text/markdown content negotiation, and the renderMarkdownAlternate export.

Repository

• Reframed as agent skills rather than Claude Code-specific — repo tagline, README intro, and the self-install flow all drop the Claude Code hardcoding.
• .claude/ session state is now gitignored.

Install

Download the .skill file for the skill you want and open it — Claude installs it automatically. Or, for any agent that supports the skills format, unzip the .skill (or clone the repo) and copy the skill folder into your agent's skills directory. Once installed, the skill will offer to keep itself up to date.

0.4

What's new in 0.4

Version tracking across all skills

• Every skill now declares a version: in its frontmatter and runs a pre-flight update check against versions.json, so you're told when the installed copy is behind the latest release.
• CI validates that manifest entries and frontmatter versions stay in sync.

Astro SEO skill

• Updated for @jdevalk/astro-seo-graph 1.0 and 1.1. Category 4 flags missing alt attributes; category 5 notes that IndexNow excludes /404 by default in ≥ 1.0.1; category 9 enables validateImageAlt, validateMetadataLength (title 30–65, description 70–200), and validateInternalLinks (with the skip escape hatch pre-wired for /images/, /fonts/, /api/).
• Fixed validator option names: validateDuplicateMeta → validateUniqueMetadata; dropped non-existent validateSchema.
• llmsTxt now passes the required options object (title, siteUrl, …) rather than a boolean.
• IndexNow is gated on a production-host env check (CF_PAGES/VERCEL_ENV/CONTEXT) so local npm run build and preview deploys don't ping the endpoint and invalidate the key.
• OG image section replaced with a concrete recipe: satori for text-heavy, sharp-composite for photo-heavy, woff2 fonts with locale fallbacks, minimal route sketch.
• Upgrade step calls out the 1.0.0 migration (buildAstroSeoProps → buildSeoContext) and the three silent bugs the rewrite fixes (articlePublisher rendering, canonical on noindex, duplicate og:image and robots tags).

Readability check skill

• New metadata mode for short strings (page titles, meta descriptions, schema description fields, FAQ answers, profile bios) where Flesch and paragraph-level checks don't apply. Checks front-loading, concreteness, aggressive filler-cutting, active voice, title/description duplication, difficult words, SERP-truncation fit, and one-idea-per-field. Output is per-string ✓/⚠/✗ with rewrites.

Repository

• README intro now names all five skill domains (GitHub, WordPress, EmDash, Astro, readability) and the installation section splits Claude Code one-click from a manual-copy path for any agent that supports the skills format.
• Repo tagline and topics refreshed.

Install

Download the .skill file for the skill you want and open it — Claude installs it automatically. Or, for any agent that supports the skills format, unzip the .skill (or clone the repo) and copy the skill folder into your agent's skills directory.

0.3

What's new in 0.3

Astro SEO skill

• Document llms.txt support shipped in @jdevalk/astro-seo-graph 0.9.0. Category 6 (agent discovery) gains a Should check for llms.txt at the site root, the integration config example enables llmsTxt: true, and a new Phase 2 subsection covers auto-collection and the sections / filter / autoSectionName / outputPath tuning options plus the renderLlmsTxt export.

Install

Download the .skill file for the skill you want and open it — Claude installs it automatically.

0.2.1

What's new in 0.2.1

Astro SEO skill

• Phase 0 now checks the installed @jdevalk/astro-seo-graph version against npm and flags drift; Phase 2 has an explicit upgrade step with a changelog pointer.

Repository hardening

• Stricter skill validation (#1 by @dknauss): closing-delimiter check on frontmatter, name: must match directory, referenced support files must exist, evals.json validated when present.
• Validator extracted to .github/scripts/validate-skills.sh so it can run locally.
• Validation triggers expanded to references/, evals/, and test-cases/ paths.
• workflow_dispatch added to validation workflows for manual re-runs.
• Baseline contributor files: CONTRIBUTING.md, SECURITY.md, CODE_OF_CONDUCT.md, SUPPORT.md, PR template, issue templates, Dependabot for GitHub Actions.

Install

Download the .skill file for the skill you want and open it — Claude installs it automatically.

0.2

What's new in 0.2

New skills

• 📖 Readability Check — Audits blog post drafts calibrated for L2 English readers. Nine checks (paragraph structure, opening paragraph, tiered sentence length, passive voice, difficult words, filler/hedging, transitions, variation, heading hierarchy) with a Flesch Reading Ease score and per-category status.
• 🚀 Astro SEO — Audits and improves SEO for Astro sites across nine categories. Routes most fixes through @jdevalk/astro-seo-graph: <Seo> component, linked JSON-LD graph, per-collection sitemaps with git-based lastmod, IndexNow, auto-generated OG images, schema endpoints, FuzzyRedirect, broken link checker in CI, and deployment-target-aware performance headers (Cloudflare / Netlify / Vercel).
• 🔷 EmDash GitHub Actions — Sets up CI/CD workflows for EmDash plugins (TypeScript type-check, ESLint, Vitest, npm publishing).

Improvements

• github-repo, github-profile, and wp-readme-optimizer now chain into readability-check on generated prose, with skill-specific guidance on which sections matter most.
• Source blocks converted to expandable <details> to keep the README scannable.

Install

Download the .skill file for the skill you want and open it — Claude installs it automatically.

0.1

Initiale release