Skip to content

Replaced AI Prompts with Agent Skills#612

Draft
brth31 wants to merge 8 commits intomainfrom
feat/quickstart-skills
Draft

Replaced AI Prompts with Agent Skills#612
brth31 wants to merge 8 commits intomainfrom
feat/quickstart-skills

Conversation

@brth31
Copy link
Contributor

@brth31 brth31 commented Feb 14, 2026

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

  • I've read and followed CONTRIBUTING.md.
  • I've tested the site build for this change locally.
  • I've made appropriate docs updates for any code or config changes.
  • I've coordinated with the Product Docs and/or Docs Management team about non-trivial changes.

brth31 and others added 4 commits February 14, 2026 10:11
- 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>
@brth31 brth31 requested a review from a team as a code owner February 14, 2026 05:29
@github-actions
Copy link

Summary

Status Count
🔍 Total 117
✅ Successful 73
⏳ Timeouts 0
🔀 Redirected 15
👻 Excluded 29
❓ Unknown 0
🚫 Errors 0
⛔ Unsupported 0

Redirects per input

Redirects 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

@brth31 brth31 marked this pull request as draft February 14, 2026 05:30
brth31 and others added 4 commits February 14, 2026 11:05
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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

DO NOT MERGE Only the PR author should merge, even if approved.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant