github Jeffallan/claude-skills v0.4.21

2 hours ago

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 becomes references/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.yml and 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 sets notes_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.yml lints and builds the docs site on every pull request and push to main, 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 TechArticle and the home page a WebPage about the repo (SoftwareSourceCode), each pointing at one Person (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), and handbook-update.yml opens a PR when it changes (#283)
  • CI: skill-linter runs as a report-only job, configured in pyproject.toml, and make skill-lint runs it locally. It will replace validate-skills.py, validate-markdown.py and update-docs.py once 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-description in SKILL.md metadata) and an intro for people from a file outside skills/ (skillIntros in site/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-title and seo-description metadata), and an intro from docs/CODE_REVIEW_SKILL.md above 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's skillIntros option and stays out of SKILL.md and 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 add with 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.md and all five references: provider majors (aws 6, azurerm 5, google 8, kubernetes 3, helm 3), use_lockfile instead of a DynamoDB lock table, import/moved/removed blocks instead of state commands, ephemeral and write-only attributes for secrets, mock_provider unit tests, and Trivy instead of tfsec (#318)
  • CI: merged the Dependabot update for softprops/action-gh-release 3.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.yml sets up Node and runs copier update --trust for that step
  • CI: skill-linter is the blocking check. The Validate job runs skill-linter release and skill-linter stamp --check, and make validate runs the same two. scripts/validate-skills.py, validate-markdown.py and update-docs.py are removed, and make skill-lint with them. CLAUDE.md and CONTRIBUTING.md describe the skill-linter commands, which make a missing "Use when" clause or Reference Guide an error (closing #288)
  • Plugin: plugin.json lists 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, including project:<phase>:<command> for the nested ones. The marketplace entry no longer lists commands (skill-linter P12)
  • CONTRIBUTING.md and CLAUDE.md describe what the validator enforces: the description formula from CLAUDE.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), so stamp --check reports 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.yml now 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.mjs keeps only this site's settings, and the skills folder, domains, docs URL and credit come from the skill-linter settings in pyproject.toml ([tool.skill-linter]). llms.txt is now written by astro-seo-graph's seoGraph(), and lists llms-full.txt under 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-python 6.3.0 → 7.0.0 (#263) and actions/configure-pages 5.0.0 → 6.0.0 (#262). Neither breaking change applies here: the workflows never use setup-python's removed pip-install input, and configure-pages' move to Node 24 runs on GitHub-hosted runners that support it. release.yml runs 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.yml builds 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; .gitignore keeps it out

Fixed

  • code-reviewer, security-reviewer, spec-miner: allowed-tools is space-separated, as the Agent Skills spec requires. game-developer, embedded-systems and swift-expert set related-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's argument-hint matches its YAML (#287, closing #274)
  • Docs site: llms.txt links left out the /claude-skills base 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 Development comment 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-ground command: moved commands/common-ground/COMMAND.md to commands/common-ground.md (and its YAML beside it) so Claude Code registers it as /fullstack-dev-skills:common-ground instead of /fullstack-dev-skills:common-ground:COMMAND. Claude Code names plugin commands after their path under commands/; the name frontmatter 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.md uses cmp.Ordered and golang.org/x/exp/constraints in place of a nonexistent constraints import; the WebSocket inactivity timer restarts on each message; presence, queue and scaling examples use the JWT-verified socket.userId; the CoreDNS cluster2.local server 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-remote and API-token setup; kept sooperset mcp-atlassian for Server/Data Center. Removed the nonexistent @anthropic/mcp-atlassian and @sooperset/mcp-atlassian packages, 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.md and CLAUDE.md with what the validator enforces (#277)
  • @ShryukGrandhi: Made six SKILL.md frontmatter values spec-compliant (#289), corrected the QUICKSTART per-domain counts and the complete-ticket argument-hint (#287), and proposed the llms.txt base-path fix that #295 took over (#286)
  • @s1ngh-code: Reported the common-ground command 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/

Don't miss a new claude-skills release

NewReleases is sending notifications on new releases.