Added
- nuxt-expert: Nuxt 4.6 skill for full-stack Nuxt apps, with references on project structure and upgrades (Nuxt 3 to 4, the Nuxt 5 compatibility flag), data fetching, server routes with
nuxt/server, rendering (route rules, islands, lazy hydration), security (runtime config secrets, nuxt-auth-utils, nuxt-security), deployment and testing. vue-expert's Nuxt 3 reference becomesreferences/ssr.md, limited to Vue SSR without Nuxt, and vue-expert and nextjs-developer link to the new skill (closing #316) - firebase-expert: Firebase skill for the modular JS SDK 13, firebase-admin 14 and Cloud Functions 2nd gen, with references on Firestore, Security Rules and their emulator tests, Authentication and Identity Platform, Cloud Functions, Storage with App Check and AI Logic, the Emulator Suite, and Hosting and App Hosting deploys. cloud-architect, secure-code-guardian, nextjs-developer, react-expert, flutter-expert and react-native-expert link to it (closing #217)
- flask-expert: Flask 3.1 and SQLAlchemy 2 skill for JSON APIs and server-rendered apps, with references on app structure, the database layer, REST APIs, templates and forms, authentication, testing and deployment. django-expert and fastapi-expert link to it (#323)
- CI:
notes-check.ymland the base schema under.handbook/base-schema/arrive with handbook v0.5.3 and check notes front matter. The default path,notes/**/*.md, matches nothing here, so it passes until the repo setsnotes_paths(#324) - Docs site: each deploy tells search engines that support IndexNow (Bing, Yandex and others) which pages changed, so they recrawl them sooner. Only the deploy build submits, and only pages whose HTML changed since the last deploy (the first deploy submits all). The key is served once for every site at
https://jeffallan.github.io/17c975f34bbe97c32cf68c4f58503478.txt - Docs site: the build fails on a broken internal link (
starlight-links-validator) - CI:
docs-site.ymllints and builds the docs site on every pull request and push tomain, so a broken link or lint error shows up in review instead of at release. The workflow is shared with the other docs sites and kept in step from the same private repo as the site code - Docs site: every page has a 1200×630 preview image (
og:image) for links shared on social sites: the site's name beside the monogram, the page title, and the page description cut to the whole sentences that fit in 260 characters. The cards are generated at build time (site/src/pages/og/) with astro-og-canvas - Docs site: every page carries a JSON-LD graph naming its author. Skill and doc pages are a
TechArticleand the home page aWebPageabout the repo (SoftwareSourceCode), each pointing at onePerson(https://jeffallan.github.io/#person) declared on the author's site. It is added through Starlight's route middleware (site/src/routeData.ts), so Starlight's own title, description and Open Graph tags stay as they are - Docs site: the shared light and dark theme (
site/src/components/site-style/), delivered from a private repo that keeps the docs sites in step: the teal palette and fonts (Outfit, Source Sans 3) from the author's site, a teal-based dark theme, and the monogram before the title, linking to that site. The purple palette is retired (#285) - Docs site: a shared footer (About the Author and Contact, the docs sites, profile links, credit line, copyright, privacy link) and a Contact call to action that opens the contact form in a dialog: under the home page's buttons, and before the first heading on skill, workflow, guide, Getting Started and Skills Guide pages. README, Changelog, Contributing, Roadmap and Privacy have none. The privacy page lists Formspree (#285)
- Docs site: the header has a Sites menu linking the author's site and both docs sites, with the current one marked. The menu (
site/src/components/site-nav/) is shared code from the same private repo, delivered with Copier (.copier-answers.yml), andhandbook-update.ymlopens a PR when it changes (#283) - CI: skill-linter runs as a report-only job, configured in
pyproject.toml, andmake skill-lintruns it locally. It will replacevalidate-skills.py,validate-markdown.pyandupdate-docs.pyonce its current findings are fixed (#279)
Changed
- Docs site: handbook v0.6.1 lets a skill page carry its own search title and description (
seo-title,seo-descriptioninSKILL.mdmetadata) and an intro for people from a file outsideskills/(skillIntrosinsite/scripts/sync-content.mjs) (#331) - Docs site: the code-reviewer page answers "code review skill" searches. Its search title is "Code Review Agent Skill for Claude Code" with a description for people (the skill's new
seo-titleandseo-descriptionmetadata), and an intro fromdocs/CODE_REVIEW_SKILL.mdabove the skill reference says what it checks, how to install it in Claude Code, and shows an example review report. The intro comes from the handbook'sskillIntrosoption and stays out ofSKILL.mdand the plugin (closing #313) - Atlassian MCP guide: titled "Connect Jira and Confluence to Claude Code" with a description naming Claude Code, Jira and Confluence. It adds setup for Atlassian's remote MCP server (
claude mcp addwith the v2 URL and OAuth) and a section on a claude.ai connector that works in Claude chat or Cowork but doesn't appear in Claude Code. API token steps now include the expiry date Atlassian requires (closing #314) - test-master: the E2E reference covers agentic and mobile E2E, naming Appium and Detox as the established mobile tools and e2e as an agent-driven option, with Playwright kept for deterministic flows (#322)
- CI: the ruff, ruff-format and pyright hooks skip
.handbook/, which the handbook delivers in its own Python style (#325) - terraform-engineer: current Terraform and provider practice across
SKILL.mdand all five references: provider majors (aws 6, azurerm 5, google 8, kubernetes 3, helm 3),use_lockfileinstead of a DynamoDB lock table,import/moved/removedblocks instead of state commands, ephemeral and write-only attributes for secrets,mock_providerunit tests, and Trivy instead of tfsec (#318) - CI: merged the Dependabot update for
softprops/action-gh-release3.0.3 → 3.0.4 (#319) - Docs site: skill page titles lead with the skill's name, as "Game Developer Agent Skill for Claude Code | Claude Skills" (was "Agent Skills for Claude Code | Game Developer | Claude Skills"), so search results show what the page is about first
- Dependabot skips the workflows the handbook delivers (
handbook-update.yml,docs-site.yml,docs-deploy.yml); the handbook bumps their actions and sends them with each release - The shared site packages (Astro, Starlight and the others listed in
CLAUDE.md) take their versions from the handbook, which sends them with each release.handbook-update.ymlsets up Node and runscopier update --trustfor that step - CI: skill-linter is the blocking check. The Validate job runs
skill-linter releaseandskill-linter stamp --check, andmake validateruns the same two.scripts/validate-skills.py,validate-markdown.pyandupdate-docs.pyare removed, andmake skill-lintwith them.CLAUDE.mdandCONTRIBUTING.mddescribe the skill-linter commands, which make a missing "Use when" clause or Reference Guide an error (closing #288) - Plugin:
plugin.jsonlists the ten commands in an object map instead of scanning./commands/, which Claude Code documents for flat command files only. The commands keep their names, includingproject:<phase>:<command>for the nested ones. The marketplace entry no longer listscommands(skill-linter P12) CONTRIBUTING.mdandCLAUDE.mddescribe what the validator enforces: the description formula fromCLAUDE.md, the section order, a five-step Core Workflow, the Reference Guide table, the Documentation backlink as the last line, and reference files without the old> Reference for:header (#277, closing #273)- Plugin and marketplace descriptions: the language, backend and frontend counts are stamped by skill-linter, which corrected them to 8 backend frameworks and 7 frontend/mobile (they said 10 and 6) (#303)
- QUICKSTART: the language, backend and frontend counts are stamped by skill-linter (
SKILL_COUNT:<domain>markers), sostamp --checkreports a stale count (#302) - Docs site: deploys on every push to
main(docs-deploy.yml, shared with the other docs sites) instead of with each release, so site changes go live without a plugin release.release.ymlnow only creates the GitHub release - Docs site: the content sync is shared code, delivered from a private repo that keeps the docs sites in step (
site/src/components/site-sync/).site/scripts/sync-content.mjskeeps only this site's settings, and the skills folder, domains, docs URL and credit come from the skill-linter settings inpyproject.toml([tool.skill-linter]).llms.txtis now written by astro-seo-graph'sseoGraph(), and listsllms-full.txtunder Optional (#295) - Docs site: skill page meta descriptions are the skill's description as written, without the "Claude Skills | <title> |" prefix. Workflow page descriptions end at a sentence instead of being cut at 160 characters (#295)
- Docs site: the Sites menu lists the Trust Center Directory (#295)
- CI: merged Dependabot updates for GitHub Actions:
actions/setup-python6.3.0 → 7.0.0 (#263) andactions/configure-pages5.0.0 → 6.0.0 (#262). Neither breaking change applies here: the workflows never use setup-python's removedpip-installinput, and configure-pages' move to Node 24 runs on GitHub-hosted runners that support it.release.ymlruns only on tags, so configure-pages 6.0.0 is first exercised at the next release - Docs site: moved to Astro 7.4 and Starlight 0.42, matching writing-with-agents. The README page keeps its body, which Astro 7 had read as frontmatter once the badge HTML was stripped, and the footer keeps the space before the Synergetic Solutions link (#278, closing #226)
- CI:
release.ymlbuilds the docs site on Node 24, since Astro 7.4 needs Node 22.23.4 or later (#280)
Removed
.serena/, the Serena project config and memories, which the repo no longer uses;.gitignorekeeps it out
Fixed
code-reviewer,security-reviewer,spec-miner:allowed-toolsis space-separated, as the Agent Skills spec requires.game-developer,embedded-systemsandswift-expertsetrelated-skills: ""instead of leaving it empty, which parsed as null (#289, closing #270)- QUICKSTART: the backend count is 8 and lists Django Storages S3, and the frontend list names Vue (JavaScript).
complete-ticket.md'sargument-hintmatches its YAML (#287, closing #274) - Docs site:
llms.txtlinks left out the/claude-skillsbase path, so all 96 returned 404. They are now absolute and include it (#272, #295) - Docs site: page titles are taken from the first heading outside code blocks. The README page had lost the
# Backend Developmentcomment from its install example, because the build took it for the page's H1 and removed it (#271, #295) - Docs site: the home page's Markdown copy links Getting Started under
/claude-skills/(#295) - Docs site: code blocks keep their frame and horizontal scrolling on pages whose first code block is a Mermaid diagram. Expressive Code puts its stylesheet in the first block, and rendering the diagram removed it; long lines ran into the "On this page" column on Workflow Commands (#284)
common-groundcommand: movedcommands/common-ground/COMMAND.mdtocommands/common-ground.md(and its YAML beside it) so Claude Code registers it as/fullstack-dev-skills:common-groundinstead of/fullstack-dev-skills:common-ground:COMMAND. Claude Code names plugin commands after their path undercommands/; thenamefrontmatter added in #186 only adds a second label (#267, closing #264)golang-pro,websocket-engineer,kubernetes-specialist: corrected eight examples. A successful Go pipeline no longer waits for its timeout; fan-out/fan-in and pipeline stages stop on cancellation while idle;generics.mdusescmp.Orderedandgolang.org/x/exp/constraintsin place of a nonexistentconstraintsimport; the WebSocket inactivity timer restarts on each message; presence, queue and scaling examples use the JWT-verifiedsocket.userId; the CoreDNScluster2.localserver block is top-level; the helm-unittest replica example disables autoscaling and lists the templates it needs; NetworkPolicy troubleshooting no longer deletes every production policy (#268, closing #266)atlassian-mcp: documented the hosted Atlassian Rovo MCP Server (https://mcp.atlassian.com/v2/mcp) as the official option, with Claude Code, Claude Desktop,mcp-remoteand API-token setup; kept soopersetmcp-atlassianfor Server/Data Center. Removed the nonexistent@anthropic/mcp-atlassianand@sooperset/mcp-atlassianpackages, corrected the xuanxt package to@xuandev/atlassian-mcp, and replaced invented environment variables with the ones sooperset reads (#269, closing #265)
Contributors
- @uridium: Brought terraform-engineer up to current Terraform and provider practice (#318)
- @Saifullah1999Pk: Added the flask-expert skill (#323)
- @kacperkapusciak: Added agentic and mobile E2E to the test-master E2E reference (#322)
- @DomeT99: Requested the nuxt-expert skill (#316)
- @Whxuan0701: Proposed documentation backlink checks and a skill scaffold generator, now covered by skill-linter (#232, #233)
- @MannXo: Aligned
CONTRIBUTING.mdandCLAUDE.mdwith what the validator enforces (#277) - @ShryukGrandhi: Made six SKILL.md frontmatter values spec-compliant (#289), corrected the QUICKSTART per-domain counts and the
complete-ticketargument-hint (#287), and proposed thellms.txtbase-path fix that #295 took over (#286) - @s1ngh-code: Reported the
common-groundcommand registering as/fullstack-dev-skills:common-ground:COMMAND(#264) - @felipecrs: Reported that the official Atlassian Rovo MCP Server was missing from
atlassian-mcp(#265) - @CBEPX: Reported the Go, WebSocket and Kubernetes example bugs (#266)
Documentation: https://jeffallan.github.io/claude-skills/