feat(skills): migrate to canonical names with deprecated aliases#6
Merged
Conversation
Rename plugin skills to match the canonical names in arcjet/skills: - New skills/add-request-protection/ — canonical HTTP route protection skill, replacing protect-route and the HTTP slice of add-ai-protection. Includes integrated CLI workflows for auth, site/key setup, decision verification (arcjet watch), and remote rule management. - skills/add-guard-protection/ synced with the canonical version, including refreshed references/javascript.md and references/python.md. - skills/protect-route/ and skills/add-ai-protection/ are now deprecation alias stubs (frontmatter metadata.internal: true). Invoking either tells the user the canonical replacement and then proceeds with the canonical skill, so existing prompts and saved transcripts continue to work. Also updates README to list canonical skills, link arcjet/skills as the source of truth, document the CLI install order (npx, brew, install script, GitHub Releases), and drop the obsolete claim that arcjet skills install writes ARCJET.md into the project. rules/arcjet-cli.mdc updated similarly. Prepares the plugin for the Arcjet CLI 1.0.0 release. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…irectly Skill installation is not a use case for the CLI — point users at `npx skills add arcjet/skills` directly when they need skills outside the plugin context.
davidmytton
approved these changes
Apr 30, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Renames the plugin's skills to match the canonical names used by arcjet/skills, in preparation for the Arcjet CLI 1.0.0 release.
The two former names (
protect-route,add-ai-protection) are kept as deprecated alias stubs so existing prompts, saved transcripts, and project-local references keep working. Invoking either alias tells the user the canonical replacement and then proceeds with the canonical workflow.Canonical skills
/arcjet:add-request-protectionprotect-routeand the HTTP slice ofadd-ai-protection/arcjet:add-guard-protectionDeprecated aliases (kept, emit deprecation diagnostic)
/arcjet:protect-route/arcjet:add-request-protection/arcjet:add-ai-protection/arcjet:add-request-protection(HTTP) or/arcjet:add-guard-protection(non-HTTP)Other changes
skills/add-guard-protection/synced with canonical content, including refreshedreferences/javascript.mdandreferences/python.md.arcjet/skillsas source of truth, documents CLI install methods (npx, Homebrew, install script, GitHub Releases archive), and drops the obsolete claim thatarcjet skills installwritesARCJET.mdinto the project.rules/arcjet-cli.mdc: updated CLI guidance to reflect the actual CLI surface (auth + site/key setup + watch + rule CRUD), removing the stalearcjet skills initializereference.CHANGELOG.md: entry under[Unreleased].Background
The companion
arcjet/skillsrepo consolidated its agent skills around two canonical names. This PR brings the plugin in line, while preserving backward compatibility via the alias mechanism that the canonical repo also uses (metadata.internal: truedeprecation stubs).