Draft
Conversation
- Updated React, Vue, Angular, Next.js quickstarts with concise agent skills accordions - Converted Express quickstart from Docusaurus to Mintlify format - Added agent skills accordion to Express quickstart - Updated Svelte to reference agent skills (coming soon) - Reduced maintenance burden by removing ~2,700 lines of duplicated prompts - Added QUICKSTART-AI-STRATEGY.md documenting the approach Co-Authored-By: Claude <noreply@anthropic.com>
## Changes ### Quickstart Documentation Updates - Updated Svelte quickstart with agent skills accordion (defaultOpen) - Updated Vanilla JS quickstart with agent skills accordion (defaultOpen) - Updated FastAPI quickstart with agent skills accordion (defaultOpen) - Each quickstart now has primary agent skills accordion + secondary framework-specific AI prompt ### Strategy Documentation - Updated QUICKSTART-AI-STRATEGY.md with Phase 3 & 4 completion - Documented 3 new agent skills created: auth0-svelte, auth0-vanilla-js, auth0-fastapi - Updated Next Steps section with remaining frameworks - Added testing checklist for new skills ## Implementation Details Each updated quickstart follows consistent pattern: - Primary: "Use AI to integrate Auth0" accordion (defaultOpen) - Install command: `npx skills add auth0/agent-skills` - Example prompt: "Add Auth0 authentication to my [Framework] app" - Link to full agent skills documentation - Secondary: Framework-specific AI prompt as alternative ## Related Work The actual agent skills were created in the agent-skills repository: - /plugins/auth0-sdks/skills/auth0-svelte/ - /plugins/auth0-sdks/skills/auth0-vanilla-js/ - /plugins/auth0-sdks/skills/auth0-fastapi/ Co-Authored-By: Claude <noreply@anthropic.com>
…stAPI quickstarts Removed the framework-specific AI prompt accordions from three quickstarts. Each quickstart now has only the agent skills accordion as the primary integration option. ## Changes - **Svelte**: Removed 72-line AI prompt accordion - **Vanilla JS**: Removed 799-line AI prompt accordion - **FastAPI**: Removed 385-line AI prompt accordion **Total reduction:** 1,256 lines removed ## Rationale The agent skills provide comprehensive, tested integration guidance through the auth0/agent-skills CLI package. The secondary AI prompts are no longer necessary now that proper agent skills exist for these frameworks. Users can now: 1. Install: `npx skills add auth0/agent-skills` 2. Ask AI: "Add Auth0 authentication to my [Framework] app" 3. Get fully automated setup with verified best practices Co-Authored-By: Claude <noreply@anthropic.com>
…arts Replaced embedded AI prompt accordions with agent skills accordions for the final 5 quickstarts that didn't have agent skills support. ## Changes **Replaced AI prompts in:** - Cap'n Web (SPA) - Removed 1,123-line AI prompt - ASP.NET Core MVC - Removed 292-line AI prompt - ASP.NET Core Blazor Server - Removed 346-line AI prompt - ASP.NET Core Web API (Backend) - Removed 145-line AI prompt - FastAPI Backend API - Removed 239-line AI prompt **Total reduction:** 2,130 lines removed ## New Agent Skills Accordion Pattern Each quickstart now has a single, clean agent skills accordion: - Title: "Use AI to integrate Auth0" - Icon: microchip-ai (solid) - defaultOpen: true - Install command: `npx skills add auth0/agent-skills` - Framework-specific example prompt - Link to full agent skills documentation ## Impact **Before:** Each quickstart had 145-1,123 line embedded AI prompts **After:** Each quickstart has ~17-line agent skills accordion All 12 quickstarts now use agent skills as the primary AI integration method, with consistent UX across all frameworks. ## Related Work Agent skills created in previous commits: - auth0-aspnet-core - auth0-blazor-server - auth0-aspnet-webapi - auth0-fastapi-backend - auth0-capnweb Co-Authored-By: Claude <noreply@anthropic.com>
Summary
Redirects per inputRedirects in main/docs/quickstart/backend/aspnet-core-webapi/index.mdx
Redirects in main/docs/quickstart/backend/fastapi/index.mdx
Redirects in main/docs/quickstart/spa/angular/index.mdx
Redirects in main/docs/quickstart/spa/react/index.mdx
Redirects in main/docs/quickstart/spa/svelte/index.mdx
Redirects in main/docs/quickstart/spa/vanillajs/index.mdx
Redirects in main/docs/quickstart/spa/vuejs/index.mdx
Redirects in main/docs/quickstart/webapp/aspnet-core-blazor-server/index.mdx
Redirects in main/docs/quickstart/webapp/aspnet-core/index.mdx
Redirects in main/docs/quickstart/webapp/express/index.mdx
Redirects in main/docs/quickstart/webapp/fastapi/index.mdx
Redirects in main/docs/quickstart/webapp/nextjs/index.mdx
|
Updated all 13 quickstarts to use framework-specific skill installation commands instead of the generic command that requires manual selection. ## Changes **Before:** ```bash npx skills add auth0/agent-skills # Shows interactive selection menu with all skills ``` **After:** ```bash npx skills add https://github.com/auth0/agent-skills --skill auth0-react # Directly installs the specific skill needed ``` ## Benefits 1. **Faster installation** - No manual selection required 2. **Less friction** - One command installs exactly what's needed 3. **Clearer intent** - Command explicitly shows which skill is being installed 4. **Better UX** - Developers can copy/paste and immediately use ## Updated Quickstarts (13) **SPA:** - React → --skill auth0-react - Vue → --skill auth0-vue - Angular → --skill auth0-angular - Svelte → --skill auth0-svelte - Vanilla JS → --skill auth0-vanilla-js - Cap'n Web → --skill auth0-capnweb **Web App:** - Next.js → --skill auth0-nextjs - Express → --skill auth0-express - FastAPI → --skill auth0-fastapi - ASP.NET Core MVC → --skill auth0-aspnet-core - Blazor Server → --skill auth0-blazor-server **Backend:** - ASP.NET Core Web API → --skill auth0-aspnet-webapi - FastAPI Backend → --skill auth0-fastapi-backend Co-Authored-By: Claude <noreply@anthropic.com>
Updated all quickstart installation commands to install both the core auth0-quickstart skill and the framework-specific skill in a single command. ## Changes **Before:** ```bash npx skills add https://github.com/auth0/agent-skills --skill auth0-react # Only installs auth0-react, missing auth0-quickstart ``` **After:** ```bash npx skills add https://github.com/auth0/agent-skills --skill auth0-quickstart --skill auth0-react # Installs both skills needed for complete setup ``` ## Why Both Skills? - **auth0-quickstart**: Handles Auth0 CLI setup, app/API creation, credential fetching - **Framework skill**: Handles SDK installation, code patterns, framework-specific setup Both are required for a successful automated Auth0 integration. ## Updated Quickstarts (13) All SPA, Web App, and Backend quickstarts now install the complete skill set: - auth0-quickstart + auth0-react - auth0-quickstart + auth0-vue - auth0-quickstart + auth0-angular - auth0-quickstart + auth0-nextjs - auth0-quickstart + auth0-express - auth0-quickstart + auth0-svelte - auth0-quickstart + auth0-vanilla-js - auth0-quickstart + auth0-fastapi - auth0-quickstart + auth0-aspnet-core - auth0-quickstart + auth0-blazor-server - auth0-quickstart + auth0-aspnet-webapi - auth0-quickstart + auth0-fastapi-backend - auth0-quickstart + auth0-capnweb Co-Authored-By: Claude <noreply@anthropic.com>
Updated all quickstart installation commands to use the short format auth0/agent-skills instead of the full GitHub URL. ## Changes **Before:** ```bash npx skills add https://github.com/auth0/agent-skills --skill auth0-quickstart --skill auth0-react ``` **After:** ```bash npx skills add auth0/agent-skills --skill auth0-quickstart --skill auth0-react ``` ## Benefits - Cleaner, more concise command - Easier to copy/paste - Standard Skills CLI format - Still installs both required skills Updated across all 13 quickstarts (SPA, Web App, Backend). Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Claude <noreply@anthropic.com>
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
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.
Description
This PR replaces verbose embedded AI prompts (200-1,123 lines each) with concise agent skills accordions (~17 lines each) across 8 Auth0 quickstarts. The migration reduces documentation size by 4,642 lines while providing a better developer experience through the auth0/agent-skills CLI package.
References
Testing
Checklist
CONTRIBUTING.md.