Consolidate 5 plugins into AgentKit and SaaSKit (v2.0.0)#20
Open
saif-at-scalekit wants to merge 36 commits into
Open
Consolidate 5 plugins into AgentKit and SaaSKit (v2.0.0)#20saif-at-scalekit wants to merge 36 commits into
saif-at-scalekit wants to merge 36 commits into
Conversation
Shift the agent-auth plugin toward a Tessl-like docs/skills/rules layout so durable AgentKit guidance is separated from Claude-specific runtime files. This makes live metadata the documented source of truth for tools while keeping existing connector notes available as secondary references. Co-authored-by: Cursor <cursoragent@cursor.com>
Raise the agent-auth plugin manifest to 2.0.0 so the hybrid AgentKit reorganization can ship as a major update and users can pick up the new version cleanly. Co-authored-by: Cursor <cursoragent@cursor.com>
Add a one-line Claude Code installer that adds the marketplace, installs the agent-auth plugin, and points users to enable auto-update. Also thread official docs.scalekit.com AgentKit links through the new canonical docs so the plugin can point back to the published product documentation. Co-authored-by: Cursor <cursoragent@cursor.com>
Add the stable llms.txt and sitemap-0.xml links to the main Claude Code auth stack docs and the canonical agent-auth docs entrypoints so users and agents have clear fallback indexes into published Scalekit documentation. Co-authored-by: Cursor <cursoragent@cursor.com>
Move the live AgentKit discovery and execution workflow into the testing skill so the plugin follows the modern skills-first structure. Keep `/test-tool` only as a legacy compatibility alias to preserve older usage without making `commands/` the source of truth. Co-authored-by: Cursor <cursoragent@cursor.com>
Restructure the marketplace from 5 separate plugins (agent-auth, full-stack-auth, mcp-auth, modular-sso, modular-scim) into 2 focused plugins: AgentKit (AI agent authentication) and SaaSKit (B2B SaaS auth). AgentKit (5 skills): - Renamed from agent-auth, adopting Scalekit AgentKit branding - Added docs/ + rules/ content model from PR #19 - Skills: integrating, discovering tools, testing tools, MCP server, production readiness SaaSKit (11 skills): - New plugin consolidating FSA, SSO, SCIM, and MCP server auth - 13 docs files including framework guides (Python, Next.js, Go, Spring Boot, Laravel) - Thin skills routing into docs/ layer - Skills: core auth, sessions, access control, SSO, SCIM, MCP OAuth, API auth, Python frameworks, Next.js, migration, production readiness - Consolidated agents, commands, hooks, and references from all 4 source plugins Both plugins at version 2.0.0 with the docs/ + rules/ + thin skills/ content model.
2 tasks
The Scalekit MCP server at mcp.scalekit.com provides tool discovery, auth link generation, and tool execution natively. The testing skill forced users to set up env vars, remember slash command syntax, and wait for a Python script — all to get the same result. Updated discovering-connector-tools, integrating-agentkit, and docs to point to the MCP server as the live playground.
… mcp-helper Removed 3 agents that don't justify being separate agents: - sdk-version-advisor: just a lookup, skills already cover SDK install - session-management-reviewer: preserved as references/session-management-patterns.md - scalekit-mcp-helper: 22 lines, MCP server + skills cover this Also removed duplicate setup-scalekit from agentkit (kept in saaskit). Remaining agents: setup-scalekit, scalekit-mcp-auth-troubleshooter.
Per-connector docs (scopes, quirks, tool categories) were present in cursor and codex but missing from claude-code. Copied full set to maintain parity across all auth stacks.
Per-connector docs are unmaintainable — live AgentKit metadata and docs.scalekit.com/agentkit/connectors/ are the source of truth.
…n dirs marketplace.json still listed the old 5 plugins (mcp-auth, agent-auth, modular-sso, modular-scim, full-stack-auth). After merge, claude plugin install agentkit@scalekit-auth-stack would fail because the marketplace manifest didn't know about agentkit or saaskit. - Replace 5 old plugin entries with agentkit + saaskit - Update marketplace description - Remove 5 old plugin directories (other repos already cleaned up)
The old 5 plugin names (agent-auth, mcp-auth, full-stack-auth, modular-sso, modular-scim) were symlinks to the new consolidated plugins (agentkit, saaskit). They were accidentally removed. Restore symlinks so both old and new install commands work: claude plugin install agent-auth@scalekit-auth-stack (old, still works) claude plugin install agentkit@scalekit-auth-stack (new, preferred) marketplace.json now lists all 7 names — 2 primary + 5 aliases.
Add the scalekit-code-doctor skill (SKILL.md + references) to both agentkit and saaskit plugins. This cross-cutting developer tool skill enables code generation and review with verified Scalekit SDK signatures across all four SDKs (Node, Python, Go, Java) and REST API.
Adds a UserPromptSubmit hook that calls the Scalekit CLI to check if the agentkit plugin is outdated. The CLI handles caching (8h TTL), GitHub API calls, semver comparison, and output formatting. - Silent when up to date - One-line message when outdated - Cross-platform: npx works on Windows, macOS, Linux - 15s timeout covers npx package resolution
UserPromptSubmit fires on every single prompt, adding npx latency to every message. SessionStart fires once when a session begins or resumes, which is the right frequency for a version check.
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
2 participants
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.
Summary
Restructures the marketplace from 5 separate plugins into 2 focused plugins: AgentKit and SaaSKit.
This PR incorporates the work from #19 (docs/agent-auth-hybrid-layout) and builds the full restructure on top.
Backward Compatibility
Old plugin names are preserved as symlinks so existing install commands keep working:
plugins/agent-authagentkitplugins/full-stack-authsaaskitplugins/mcp-authsaaskitplugins/modular-ssosaaskitplugins/modular-scimsaaskitTested:
claude plugin install agent-auth@scalekit-auth-stackresolves through the symlink and loads AgentKit skills. Claude Code's marketplace uses git clone, which preserves symlinks on disk.The install script (
scripts/install_claude_marketplace.sh) now:Namespace Change
/agentkit:or/saaskit:namespaceAgentKit (5 skills)
Renamed from
agent-auth, adopting Scalekit AgentKit branding withdocs/ + rules/ + thin skills/content model.integrating-agentkitdiscovering-connector-toolsexposing-agentkit-via-mcpproduction-readiness-agentkitscalekit-code-doctorSaaSKit (13 skills)
New plugin consolidating FSA, SSO, SCIM, and MCP server auth into one coherent surface.
implementing-saaskitmanaging-saaskit-sessionsimplementing-access-controlimplementing-saaskit-pythonimplementing-saaskit-nextjsimplementing-modular-ssoimplementing-scim-provisioningadding-mcp-oauthadding-api-authmigrating-to-saaskitproduction-readiness-saaskittesting-auth-setupscalekit-code-doctorContent model
Both plugins follow:
docs/(canonical documentation) +rules/(cross-cutting guidance) + thinskills/(routing layers pointing to docs)Cleanup in this PR
test-tool.mdcommand aliasagent-connectors/*.mdfiles — pointed todocs.scalekit.com/agentkit/connectors/insteadproviders.md→connectors.mdto match product terminologybuilding-agentkit-mcp-server→exposing-agentkit-via-mcp(configuring, not building)discovering-agentkit-tools→discovering-connector-tools(tools belong to connectors)dryruncommand →testing-auth-setupskill (discoverable via natural language)saaskit/hooks/hooks.json—typewas on wrong nesting levelPre-merge Coordination Checklist
1. docs.scalekit.com (developer-docs repo)
Claude Code install templates — update to use new plugin names:
src/components/templates/coding-agents/_agentkit-claude-code.mdx—agent-auth@→agentkit@src/components/templates/coding-agents/_fsa-claude-code.mdx—full-stack-auth@→saaskit@src/components/templates/coding-agents/_mcp-auth-claude-code.mdx—mcp-auth@→saaskit@src/components/templates/coding-agents/_sso-claude-code.mdx—modular-sso@→saaskit@src/components/templates/coding-agents/_scim-claude-code.mdx—modular-scim@→saaskit@GitHub Copilot CLI and Codex templates — same pattern:
_agentkit-github-copilot-cli.mdx/_agentkit-codex.mdx_fsa-github-copilot-cli.mdx/_fsa-codex.mdx_mcp-auth-github-copilot-cli.mdx/_mcp-auth-codex.mdx_sso-github-copilot-cli.mdx/_sso-codex.mdx_scim-github-copilot-cli.mdx/_scim-codex.mdxDocs pages with inline install commands:
src/content/docs/dev-kit/build-with-ai/index.mdx— master plugin install tablesrc/content/docs/cookbooks/set-up-agentkit-with-your-coding-agent.mdxsrc/content/docs/agentkit/quickstart.mdxsrc/content/docs/authenticate/fsa/quickstart.mdxsrc/content/docs/authenticate/mcp/quickstart.mdxsrc/content/docs/authenticate/sso/add-modular-sso.mdxsrc/content/docs/directory/scim/quickstart.mdxsrc/content/docs/home/saaskit/index.mdxsrc/content/docs/sso/quickstart.mdxsrc/content/docs/passwordless/quickstart.mdxsrc/content/docs/passwordless/oidc.mdxsrc/content/docs/agent-auth/start-agent-auth-coding-agents/(referenced in web search)Config files:
src/configs/agent-instructions.tssrc/configs/llms.config.ts2. scalekit.com marketing pages
scalekit.com) — has inline Claude plugin install commands with old names/agent-authproduct page — hasagent-auth@scalekit-auth-stackinstall command/product-updates/add-scalekit-from-your-coding-agent— has old install commands3. scalekit.com blog posts
/blog/outbound-prospecting-agent-development— hasagent-auth@scalekit-auth-stack4. Scalekit dashboard app (app.scalekit.com)
app/scalekit-web-ui/src/pages/Quickstart/snippets.ts— has old plugin install commands5. build-with-ai/skills repo (scalekit-inc/skills)
17 files reference old plugin names:
skills/setup-scalekit/SKILL.mdskills/integrating-agent-auth/SKILL.mdskills/building-agent-mcp-server/SKILL.mdskills/production-readiness-agent-auth/SKILL.mdskills/production-readiness-full-stack-auth/SKILL.mdskills/production-readiness-mcp-auth/SKILL.mdskills/modular-sso/SKILL.mdskills/mcp-auth-expressjs-scalekit/SKILL.mdskills/mcp-auth-fastmcp-scalekit/SKILL.mdskills/mcp-auth-fastapi-fastmcp-scalekit/SKILL.mdskills/mcp-oauth-fastmcp/SKILL.mdskills/adding-mcp-oauth/SKILL.mdskills/express-mcp-server/SKILL.mdskills/fastapi-fastmcp/SKILL.mdskills/README.md6. Third-party listings
These are external and may update automatically, but worth tracking:
7. Install script — Windows compatibility
install.shuses bash (set -euo pipefail,curl,tar,mktemp) — does not work on Windowsinstall.ps1) or cross-platform alternative/plugin marketplace addmethod8. Post-merge verification
claude --plugin-dir(tested locally)/plugin marketplace add scalekit-inc/claude-code-authstack→/plugin install agentkit@scalekit-auth-stack/plugin install saaskit@scalekit-auth-stack/plugin install agent-auth@scalekit-auth-stack(should resolve via symlink)--plugin-dirlocal testing works for both plugins