Skip to content

feat(auth0): surface auth0 docs search across skill references - #239

Merged
developerkunal merged 1 commit into
mainfrom
feat/docs-search-references
Oct 1, 2026
Merged

developerkunal merged 1 commit into
mainfrom
feat/docs-search-references

Conversation

@developerkunal

@developerkunal developerkunal commented Oct 1, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Surfaces the auth0 docs search command across the skill's reference files, so an agent looks up the current Auth0 documentation page from the terminal instead of relying on a hardcoded link that may have moved.

What changed

  • Added a one-line auth0 docs search "<keyword>" hint to the References section of every reference that cites auth0.com/docs links (45 files).
  • Each keyword is matched to the file's topic, so the example points an agent at the right starting query (for example, swift sdk, customize login page, bulk user import).
  • The hint appears once per file. A few large references concatenate several sub-documents, each with its own References list; those keep the hint only in the first (primary) section rather than repeating it.
  • Three files without a standard ## References footer were handled in place: feature-universal-portals (under ## Sources), framework-nuxt (after its Links line), and feature-organizations (a minimal References section added, since it only had an inline docs link).

The CLI reference (tooling-cli/index.md) already documents the auth0 docs search command itself; this change propagates awareness of it across the rest of the skill.

Verification

  • Every keyword was run through auth0 docs search to confirm it returns a relevant page before being used in a hint.
  • uvx skillsaw --strict passes with 0 errors (Grade A+).
  • Router reachability and routing evals both pass.

Summary by CodeRabbit

  • Documentation
    • Added guidance for finding the latest Auth0 documentation across supported features, frameworks, and tooling using the Auth0 CLI.

Add a one-line `auth0 docs search "<keyword>"` hint to the References section of every reference that cites auth0.com/docs links, so an agent pulls the current doc page from the terminal instead of relying on a hardcoded link that may move. Each keyword is matched to the file's topic and verified against the CLI's results. One hint per file.

DXCDT-2450
@coderabbitai

coderabbitai Bot commented Oct 1, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository: auth0/agent-skills/.coderabbit.yaml

Review profile: ASSERTIVE

Plan: Advanced

Run ID: 0310e993-a392-44e6-9485-8dce3882c5ed

📥 Commits

Reviewing files that changed from the base of the PR and between 8a5d43b and a3d47e2.

📒 Files selected for processing (45)
  • plugins/auth0/skills/auth0/references/feature-branding/index.md
  • plugins/auth0/skills/auth0/references/feature-custom-domains/index.md
  • plugins/auth0/skills/auth0/references/feature-mfa/index.md
  • plugins/auth0/skills/auth0/references/feature-migration/index.md
  • plugins/auth0/skills/auth0/references/feature-organizations/index.md
  • plugins/auth0/skills/auth0/references/feature-passkeys/index.md
  • plugins/auth0/skills/auth0/references/feature-universal-portals/index.md
  • plugins/auth0/skills/auth0/references/framework-android/index.md
  • plugins/auth0/skills/auth0/references/framework-angular/index.md
  • plugins/auth0/skills/auth0/references/framework-aspnetcore-api/index.md
  • plugins/auth0/skills/auth0/references/framework-aspnetcore-auth/index.md
  • plugins/auth0/skills/auth0/references/framework-expo/index.md
  • plugins/auth0/skills/auth0/references/framework-express-jwt/index.md
  • plugins/auth0/skills/auth0/references/framework-express/index.md
  • plugins/auth0/skills/auth0/references/framework-fastapi-api/index.md
  • plugins/auth0/skills/auth0/references/framework-fastify-api/index.md
  • plugins/auth0/skills/auth0/references/framework-fastify/index.md
  • plugins/auth0/skills/auth0/references/framework-flask/index.md
  • plugins/auth0/skills/auth0/references/framework-flutter-native/index.md
  • plugins/auth0/skills/auth0/references/framework-flutter-web/index.md
  • plugins/auth0/skills/auth0/references/framework-flutter-windows/index.md
  • plugins/auth0/skills/auth0/references/framework-go/index.md
  • plugins/auth0/skills/auth0/references/framework-ionic-angular/index.md
  • plugins/auth0/skills/auth0/references/framework-ionic-react/index.md
  • plugins/auth0/skills/auth0/references/framework-ionic-vue/index.md
  • plugins/auth0/skills/auth0/references/framework-java-mvc/index.md
  • plugins/auth0/skills/auth0/references/framework-laravel-api/index.md
  • plugins/auth0/skills/auth0/references/framework-laravel/index.md
  • plugins/auth0/skills/auth0/references/framework-maui/index.md
  • plugins/auth0/skills/auth0/references/framework-net-android/index.md
  • plugins/auth0/skills/auth0/references/framework-net-ios/index.md
  • plugins/auth0/skills/auth0/references/framework-nextjs/index.md
  • plugins/auth0/skills/auth0/references/framework-nuxt/index.md
  • plugins/auth0/skills/auth0/references/framework-php-api/index.md
  • plugins/auth0/skills/auth0/references/framework-php/index.md
  • plugins/auth0/skills/auth0/references/framework-react-native/index.md
  • plugins/auth0/skills/auth0/references/framework-react/index.md
  • plugins/auth0/skills/auth0/references/framework-spa-js/index.md
  • plugins/auth0/skills/auth0/references/framework-springboot-api/index.md
  • plugins/auth0/skills/auth0/references/framework-swift/index.md
  • plugins/auth0/skills/auth0/references/framework-tanstack-start/index.md
  • plugins/auth0/skills/auth0/references/framework-vue/index.md
  • plugins/auth0/skills/auth0/references/framework-winforms/index.md
  • plugins/auth0/skills/auth0/references/framework-wpf/index.md
  • plugins/auth0/skills/auth0/references/tooling-cli/index.md

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.


📝 Walkthrough

Walkthrough

Auth0 feature, framework, and CLI reference pages now direct readers to search Auth0 documentation with topic-specific auth0 docs search commands. The MFA reference also adds punctuation to an existing link.

Changes

Auth0 Documentation Search

Layer / File(s) Summary
Add documentation search instructions
plugins/auth0/skills/auth0/references/feature-*, plugins/auth0/skills/auth0/references/framework-*, plugins/auth0/skills/auth0/references/tooling-cli/index.md
Feature, framework, and CLI reference pages add topic-specific auth0 docs search commands. The MFA page keeps its existing links and adds punctuation to the Step-Up Authentication link.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~10 minutes

Change: Other

Merge Risk: ⚪ Minimal · up to a3d47

The reference pages add topic-specific ways to find current Auth0 documentation without changing the CLI command or existing MFA links. No actionable merge risk is evident.

Architecture Summary

Architecture risk: 🔵 Low · up to a3d47

The change affects 1 system.

Changed systems: plugins

Architecture concerns
No architecture-level concerns identified.

Review details

Systems and components

  • observed — plugins (service) was modified; 45 changed files map to changed impact.

Before / after behavior

  • observed — Modified behavior in plugins/auth0/skills/auth0/references/feature-branding/index.md: Added an instruction to search Auth0 docs for the latest guidance on customizing the login page.
  • observed — Modified behavior in plugins/auth0/skills/auth0/references/feature-custom-domains/index.md: Added an instruction to run auth0 docs search "custom domains" for current Auth0 documentation.
  • observed — Modified behavior in plugins/auth0/skills/auth0/references/feature-mfa/index.md: The References section adds the Auth0 docs search command; the existing MFA links remain, and the Step-Up Authentication link now ends with a period.
  • observed — Modified behavior in plugins/auth0/skills/auth0/references/feature-migration/index.md: Adds an auth0 docs search command for querying current Auth0 documentation about bulk user import.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the main change: adding auth0 docs search guidance across Auth0 skill references.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR
  • Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Autopilot is currently an internal CodeRabbit preview.


Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actions Bot commented Oct 1, 2026

Copy link
Copy Markdown

✅ skillsaw — All checks passed

Full report
skillsaw 0.16.0
Linting: /home/runner/work/agent-skills/agent-skills


Scanned:
  Repo type: agentskills, coderabbit, marketplace
  Plugins:   1
  Skills:    1
  Rules run: 51
  Took:      2.0s

Summary:
  Errors:   0
  Warnings: 0
  Grade:    A (1.60 weighted violations per 10k tokens)
  16 info-level violation(s) count toward the grade — run with -v to see them

✓ All checks passed!

skillsaw 0.16.0 · config · custom rules · run

@developerkunal
developerkunal merged commit 1e9376f into main Oct 1, 2026
6 checks passed
@developerkunal
developerkunal deleted the feat/docs-search-references branch October 1, 2026 11:49
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.

2 participants