Skip to content

feat: add auth0-cli skill for CLI resource management#27

Open
cristiandouce wants to merge 2 commits into
auth0:mainfrom
cristiandouce:auth0-cli
Open

feat: add auth0-cli skill for CLI resource management#27
cristiandouce wants to merge 2 commits into
auth0:mainfrom
cristiandouce:auth0-cli

Conversation

@cristiandouce

Copy link
Copy Markdown
Contributor

Summary

Adds a new auth0-cli skill to the core auth0 plugin, providing comprehensive guidance for managing Auth0 resources via the CLI. This skill helps AI agents generate correct auth0 CLI commands instead of hallucinating non-existent flags and subcommands.

What's included

New skill: auth0-cli

  • SKILL.md — Overview covering installation, authentication (interactive + CI/CD), command categories, common mistakes, and security best practices
  • references/commands.md — Complete CLI command reference organized by category (apps, APIs, users, roles, organizations, actions, logs, universal login, testing) with detailed flag tables
  • references/workflows.md — Step-by-step workflow recipes for common tasks: setting up new apps, debugging auth failures, bulk user management, deploying actions, log streaming, and CI/CD automation
  • references/advanced.md — Advanced features including Terraform generation, attack protection, custom domains, email/phone providers, event streams, token exchange, and network ACLs

Cross-references across all existing skills

Added auth0-cli as a related skill in all 11 existing skills so agents can discover it when working on any Auth0 integration:

  • Core skills: auth0-quickstart, auth0-migration, auth0-mfa
  • SDK skills: auth0-react, auth0-nextjs, auth0-vue, auth0-angular, auth0-express, auth0-fastify, auth0-fastify-api, auth0-react-native

Plugin and marketplace updates

  • Updated plugin.json description to mention CLI management
  • Updated marketplace.json description and keywords to include cli
  • Updated README.md with the new skill in listings and project structure

Why this matters

Without this skill, AI agents frequently hallucinate incorrect CLI commands — using non-existent flags like auth0 logs list --follow instead of the correct auth0 logs tail, or suggesting environment variables are auto-detected for authentication instead of the actual auth0 login --client-id --client-secret --domain command. During evaluation, the skill improved assertion pass rates from 61% to 100% across test scenarios covering SPA creation, auth debugging, and CI/CD automation.

@ramya18101

ramya18101 commented Apr 13, 2026

Copy link
Copy Markdown
Contributor

Hello @cristiandouce ,

Thanks for taking the initiative to add auth0-cli to agent skills, really appreciate it!
I see that we’ve covered all the existing commands, but it would be great to also think about automating updates for any changes to existing commands or newly added ones.

I explored a few options, and one possible approach could be:

  • Creating an automated PR using Claude (if agent-skills has a configured ANTHROPIC_API_KEY stored in GitHub Secrets)
  • Scheduling a weekly trigger to detect new changes/releases in auth0-cli and generate a PR accordingly

Would love to hear your thoughts on this approach as well.

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.

3 participants