Skip to content

chore: rewrite Agent Skills page for the single auth0 skill#1499

Draft
frederikprijck wants to merge 1 commit into
auth0:mainfrom
frederikprijck:chore/agent-skills-single-skill-rewrite
Draft

chore: rewrite Agent Skills page for the single auth0 skill#1499
frederikprijck wants to merge 1 commit into
auth0:mainfrom
frederikprijck:chore/agent-skills-single-skill-rewrite

Conversation

@frederikprijck

Copy link
Copy Markdown
Member

What

Companion to #1498. The agent-skills re-architecture (auth0/agent-skills#137) consolidates all per-SDK skills into one auth0 skill whose internal router reads your project files, detects the framework, and loads the matching reference files.

The Agent Skills hub page (main/docs/quickstart/agent-skills.mdx) was still written for the old multi-skill catalog model. This updates the prose so it describes a single skill.

Changes

  • "How it works" — step now describes the auth0 skill's router loading reference files (was "activates the matching skill from 25 available"). Info callout reframed to "a single auth0 skill" and adds the /auth0 explicit-invocation escape hatch for smaller models.
  • "Available skills" → "What it covers" — dropped the "25 skills" count and the per-skill framing; the section now describes what the one skill covers.
  • Table headers SkillCapability (6 tables); rows now read as coverage areas of the single skill rather than separately installable skills. "Quickstart Router" row renamed to "Framework detection."
  • GitHub card — "all 25 skill definitions" → "the auth0 skill definition."

Not touched

  • Install instructions (Claude Code plugin, Cursor, Copilot, whole-repo CLI) — already reference the auth0 plugin / whole auth0/agent-skills repo, so they're unaffected by the collapse to one skill.
  • Capability tables' framework rows and example prompts — still accurate coverage, kept as-is.

Grounding

Single-skill architecture and router behavior per the unified-skill branch README; skill folder confirmed named auth0.

The agent-skills re-architecture (auth0/agent-skills#137) consolidates
all per-SDK skills into one auth0 skill whose internal router detects
the framework and loads the matching reference files.

Update the Agent Skills page so it no longer describes a catalog of
separate skills:
- 'How it works' now describes the single auth0 skill's router loading
  reference files, and notes the /auth0 explicit-invocation escape hatch.
- Reframe 'Available skills' -> 'What it covers'; drop the '25 skills'
  count and per-skill framing.
- Table headers Skill -> Capability; the rows now read as coverage of the
  one skill rather than distinct installable skills.
- Update the GitHub card to reference the single auth0 skill definition.

Install instructions (plugin + whole-repo CLI) already reference the
auth0 plugin and are unchanged.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant