Skip to content

Consolidate 5 plugins into AgentKit + SaaSKit#12

Open
saif-at-scalekit wants to merge 15 commits into
mainfrom
restructure/agentkit-saaskit
Open

Consolidate 5 plugins into AgentKit + SaaSKit#12
saif-at-scalekit wants to merge 15 commits into
mainfrom
restructure/agentkit-saaskit

Conversation

@saif-at-scalekit
Copy link
Copy Markdown
Collaborator

@saif-at-scalekit saif-at-scalekit commented May 12, 2026

Summary

Restructures from 5 plugins to 2 unified plugins matching the Claude Code authstack architecture.

Before: 5 plugins

  • agent-auth, full-stack-auth, mcp-auth, modular-sso, modular-scim

After: 2 plugins

  • AgentKit — AI agent authentication (from agent-auth)
  • SaaSKit — B2B SaaS authentication (from full-stack-auth + mcp-auth + modular-sso + modular-scim)

AgentKit (5 skills, 3 rules, 44 connector docs)

integrating-agentkit, discovering-connector-tools, exposing-agentkit-via-mcp, production-readiness-agentkit, scalekit-code-doctor

SaaSKit (13 skills, 2 rules, 5 agents)

implementing-saaskit, implementing-saaskit-nextjs, implementing-saaskit-python, implementing-modular-sso, implementing-scim-provisioning, adding-mcp-oauth, implementing-access-control, managing-saaskit-sessions, migrating-to-saaskit, adding-api-auth, testing-auth-setup, production-readiness-saaskit, scalekit-code-doctor

Content improvements included

  • Removed beta SDK version pin
  • Fixed broken CONNECTORS.md link
  • Fixed stale Reddit link in modular-sso
  • Added 4 missing connector docs
  • Fixed auth type claim in connector README

Validation: node scripts/validate-template.mjs passes.

Supersedes #10 and #11.

Restructure from 5 plugins (agent-auth, full-stack-auth, mcp-auth,
modular-sso, modular-scim) to 2 plugins (agentkit, saaskit) matching
the Claude Code authstack architecture.

AgentKit (from agent-auth):
- 5 skills: integrating-agentkit, discovering-connector-tools,
  testing-agentkit-tools, exposing-agentkit-via-mcp,
  production-readiness-agentkit
- 3 rules: terminology, live-metadata-first, tool-selection
- 44 connector reference docs + 6 reference files
- 1 agent: setup-scalekit

SaaSKit (from full-stack-auth + mcp-auth + modular-sso + modular-scim):
- 5 skills: implementing-saaskit, implementing-modular-sso,
  implementing-scim-provisioning, adding-mcp-oauth,
  production-readiness-saaskit
- 2 rules: terminology, redirect-urls
- 5 reference files + 3 MCP framework references
- 5 agents (deduplicated from originals)

Also includes content improvements:
- Renamed skill frontmatter to match new plugin names
- Removed beta SDK version pin
- Fixed broken CONNECTORS.md link
- Fixed stale Reddit link in modular-sso
- Added 4 missing connector docs (Attention, Chorus, Clari Copilot,
  Google Slides)
- Fixed auth type claim in connector README
- Updated marketplace manifest, AGENTS.md, and root README
Cursor now supports native MCP server URLs directly. Removes the
npx mcp-remote proxy from both plugin .mcp.json files, updates the
hosted-server code example in scalekit-mcp-server.md, and replaces
MCP-Remote troubleshooting steps with Cursor-native instructions in
the MCP auth troubleshooter agent.

Folds in the changes from PR #9.
… mcp-helper

Removed 3 agents that don't justify being separate agents.
Session management content preserved as references/session-management-patterns.md.
Also removed duplicate setup-scalekit from agentkit (kept in saaskit).
Remaining agents: setup-scalekit, scalekit-mcp-auth-troubleshooter.
…ifests

Skills added to saaskit:
- adding-api-auth, implementing-access-control, implementing-saaskit-nextjs,
  implementing-saaskit-python, managing-saaskit-sessions, migrating-to-saaskit,
  testing-auth-setup

Hooks added (Cursor format):
- agentkit/hooks/hooks.json + beacon.sh (sessionEnd event)
- saaskit/hooks/hooks.json + beacon.sh (sessionEnd event)

Terminology fixes:
- 27 'Agent Auth' -> 'AgentKit' across 9 files
- providers.md renamed to connectors.md with full rewrite
- integrating-agent-auth -> integrating-agentkit stale ref fixed

Reference added:
- agentkit/references/tool-discovery.md (Cursor-adapted)

Agent frontmatter fixed (Cursor spec):
- setup-scalekit.md: stripped model/tools/maxTurns, fixed old 5-plugin paths
- scalekit-mcp-auth-troubleshooter.md: stripped Claude fields, genericized refs

Manifests fixed:
- mcpServers .mcp.json -> mcp.json (matching actual files)
- Removed empty agentkit agents/ dir and manifest ref
- Added hooks field to both plugin.json
- Added logo field to plugin.json and marketplace.json

AGENTS.md updated: connectors.md, mcp.json, hooks, new skills list
Per-connector docs are unmaintainable — live AgentKit metadata and
docs.scalekit.com/agentkit/connectors/ are the source of truth.
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.
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