mirror of https://github.com/auth0/agent-skills.git synced 2026-09-19 02:38:28 +08:00

Files

T

Bharath Natarajan 16f66d3c0b fix: align docs with single-plugin merge (#57 )

* fix: update PLUGIN.md and CONTRIBUTING.md for single-plugin architecture

After #50 merged auth0-sdks into auth0, PLUGIN.md and CONTRIBUTING.md
still documented the old two-plugin architecture.

PLUGIN.md: Complete rewrite reflecting single unified plugin
CONTRIBUTING.md: Update all paths from plugins/auth0-sdks/ to plugins/auth0/

* fix: add missing README.md to tree, normalize keywords across configs

- PLUGIN.md: add plugins/auth0/README.md to directory tree
- Normalize keyword lists across Claude/Cursor marketplace.json and
  Cursor plugin.json to identical 27-keyword set
- Add missing keywords: flask, springboot, java, spa-js
- Remove stale keywords: servlet, java-mvc, express-jwt, fastify-api

2026-04-22 22:11:18 +05:30

5.0 KiB

Raw Permalink Blame History

Claude Code Plugin Architecture

This repository provides a single Claude Code plugin managed by a marketplace.json file.

Architecture Overview

Marketplace File

One marketplace.json at the root level lists the plugin:

{
  "name": "auth0-agent-skills",
  "plugins": [
    {
      "name": "auth0",
      "source": "plugins/auth0",
      ...
    }
  ]
}

One Plugin, All Skills

Plugin: auth0 — All Auth0 agent skills in a single plugin.

Core skills:

auth0-quickstart - Framework detection and routing
auth0-migration - Migrate from other auth providers
auth0-mfa - Multi-Factor Authentication

Frontend framework skills:

auth0-react - React SPAs
auth0-vue - Vue.js 3
auth0-angular - Angular 12+
auth0-spa-js - Vanilla JS SPAs

Backend/fullstack framework skills:

auth0-nextjs - Next.js
auth0-nuxt - Nuxt 3/4
auth0-express - Express.js
auth0-flask - Flask
auth0-fastify - Fastify web applications
auth0-fastify-api - Fastify API authentication
auth0-fastapi-api - FastAPI API authentication
auth0-java-mvc-common - Java Servlet web applications
auth0-springboot-api - Spring Boot API authentication
auth0-aspnetcore-api - ASP.NET Core API authentication
express-oauth2-jwt-bearer - Node.js/Express API JWT Bearer validation

Mobile skills:

auth0-android - Android (Kotlin/Java)
auth0-swift - iOS/macOS (Swift)
auth0-react-native - React Native CLI (bare workflow)
auth0-expo - Expo (managed workflow)

Directory Structure

auth0/agent-skills/
├── .claude-plugin/
│   └── marketplace.json          # Marketplace metadata
├── .cursor-plugin/
│   └── marketplace.json          # Cursor marketplace metadata
├── plugins/
│   └── auth0/                    # Single unified plugin
│       ├── .claude-plugin/
│       │   └── plugin.json       # Claude plugin config
│       ├── .cursor-plugin/
│       │   └── plugin.json       # Cursor plugin config
│       ├── .codex-plugin/
│       │   └── plugin.json       # Codex plugin config
│       ├── README.md
│       └── skills/
│           ├── auth0-quickstart/
│           ├── auth0-migration/
│           ├── auth0-mfa/
│           ├── auth0-react/
│           ├── auth0-vue/
│           ├── auth0-angular/
│           ├── auth0-spa-js/
│           ├── auth0-nextjs/
│           ├── auth0-nuxt/
│           ├── auth0-express/
│           ├── auth0-flask/
│           ├── auth0-fastify/
│           ├── auth0-fastify-api/
│           ├── auth0-fastapi-api/
│           ├── auth0-java-mvc-common/
│           ├── auth0-springboot-api/
│           ├── auth0-aspnetcore-api/
│           ├── express-oauth2-jwt-bearer/
│           ├── auth0-react-native/
│           ├── auth0-expo/
│           ├── auth0-android/
│           └── auth0-swift/
├── .gitignore
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── PLUGIN.md
└── README.md

File Purposes

.claude-plugin/marketplace.json

Purpose: Master marketplace listing for the plugin

Location: .claude-plugin/marketplace.json

Contains:

Repository metadata (name, version, author, license)
Plugin configuration with source path
Skills are auto-discovered from the skills/ directory within the plugin

plugins/auth0/.claude-plugin/plugin.json

Purpose: Plugin-specific configuration

Contains:

Plugin name, display name, and version
Plugin description
Skills are auto-discovered from the skills/ directory

Installation Methods

Method 1: Marketplace (Recommended)

Open Claude Code
Navigate to Settings > Plugins
Search "Auth0"
Install "Auth0 Agent Skills"

Method 2: CLI Installation

# Install all skills
npx skills add auth0/agent-skills

# Install individual skill
npx skills add auth0/agent-skills/plugins/auth0/skills/auth0-quickstart

Method 3: Manual Installation

git clone https://github.com/auth0/agent-skills.git
cd agent-skills

# Copy all skills
cp -r plugins/auth0/skills/* ~/.claude/skills/

Use Cases

Install Everything (Most Common)

User installs "Auth0 Agent Skills" from marketplace -> gets the plugin with all 22 skills.

Install One Framework

Developer working on React app -> uses CLI to install just auth0-react skill.

Publishing

Update Version

Edit .claude-plugin/marketplace.json and plugins/auth0/.claude-plugin/plugin.json.

Create Release

git add .
git commit -m "Release vX.Y.Z"
git tag vX.Y.Z
git push origin main --tags

Support

GitHub Issues: https://github.com/auth0/agent-skills/issues
Email: support@auth0.com
Documentation: README.md for usage, PLUGIN.md for architecture

5.0 KiB Raw Permalink Blame History