Skip to content

Consolidate 5 plugins into AgentKit + SaaSKit#6

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

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

Conversation

@saif-at-scalekit
Copy link
Copy Markdown
Contributor

@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)

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

SaaSKit (13 skills)

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

Framework sub-skills converted to reference files within parent skills (Go, Spring Boot, Laravel, FastAPI, Flask, FastMCP, Express).

Content improvements included

  • Renamed all skill frontmatter to match new plugin names
  • Removed beta SDK version pin
  • Fixed broken CONNECTORS.md link

Validation: python3 scripts/validate_marketplace.py passes.

Supersedes #5.

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 (5 skills):
- integrating-agentkit, discovering-connector-tools,
  testing-agentkit-tools, exposing-agentkit-via-mcp,
  production-readiness-agentkit
- 44 connector reference docs + 6 reference files

SaaSKit (11 skills):
- 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,
  production-readiness-saaskit
- Framework references: Go, Spring Boot, Laravel, FastAPI, Flask
- MCP framework references: FastMCP, Express, FastAPI

Content improvements included:
- Renamed all skill frontmatter to match new plugin names
- Removed beta SDK version pin
- Fixed broken CONNECTORS.md link
- Validation passes: validate_marketplace.py

Supersedes #5.
- Replace 5 old plugin entries with agentkit + saaskit in personal marketplace
- Add cleanup of old v1.x plugin directories on re-install
- Update CHANGELOG to reflect consolidation
- Add testing-auth-setup skill to saaskit (npx dryrun CLI)
- Add session-management-patterns.md reference to saaskit
- Add tool-discovery.md reference to agentkit (adapted for Codex)
- Add setup-scalekit.md reference (converted from agent)
- Add mcp-auth-troubleshooting.md reference (converted from agent)
- Rename providers.md to connectors.md, fix terminology to AgentKit/connectors
- Update connectors table with Attention, Chorus, Clari Copilot, Google Slides
- Update AGENTS.md and saaskit README to reflect new files
- Replace 'Agent Auth' with 'AgentKit' in 8 files (skills, references)
- Fix stale skill reference: integrating-agent-auth → integrating-agentkit
- Fix stale URL: /agent-auth/connected-accounts → connected-accounts.md
- Add hooks/hooks.json and hooks/beacon.sh to agentkit and saaskit
- Beacon sends plugin_used event to PostHog on session stop
- Update AGENTS.md to reflect hooks support
- Remove non-existent CODEX_PLUGIN_ROOT variable, use relative path
- Remove extra description field from hooks.json
- Add hooks field to both plugin.json manifests
Per-connector docs are unmaintainable — live AgentKit metadata and
docs.scalekit.com/agentkit/connectors/ are the source of truth.
Main branch has scripts/install_codex_marketplace.sh. The feature branch
renamed it to scripts/install.sh. Docs and websites may still reference
the old name. Add a wrapper that forwards to install.sh.
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.
Add step 3 (npm i -g @scalekit-inc/cli) consistent with the other authstack
repos. Renumber subsequent steps accordingly.
- Update README doc links to current paths (/authenticate/sso/...,
  /authenticate/mcp/..., /agentkit/...) matching source of truth.
- Remove stale @2.2.0-beta.1 version pin from adding-mcp-oauth install
  command (SDK is now at 2.6.0).
- Fix pip install commands: scalekit -> scalekit-sdk-python,
  scalekit-sdk -> scalekit-sdk-python (4 files).
- Remove broken token-management.md link from integrating-agentkit
  and connected-accounts.md (file does not exist).
/mcp/authentication -> /authenticate/mcp/quickstart/
- Sync 13 drifted skill descriptions to match claude-code SOT
- Standardize SaaSKit terminology (replace FSA references)
- Normalize adding-api-auth from multiline YAML to single-line
All 18 skills updated with quality improvements:
- Removed verbose meta-commentary, added verification commands
- Added concrete code examples from scalekit-code-doctor references
- Consolidated duplicated content into reference files
- Improved descriptions with specific trigger terms

New reference files added for scalekit-code-doctor (EXAMPLE-REPOS.md).
saif-shines and others added 11 commits May 21, 2026 22:13
- scim-provisioning: pip install scalekit-sdk → scalekit-sdk-python
- adding-mcp-oauth: Scalekit → ScalekitClient (SKILL.md + express-reference.md)
- bring-your-own-auth: Scalekit → ScalekitClient
- agentkit README: add missing scalekit-code-doctor skill
- saaskit README: add missing scalekit-code-doctor skill

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…, dedup

- implementing-modular-sso: fix access token expiry 24h → 5min (configurable)
- implementing-saaskit-python: add django-reference.md and flask-reference.md
- agentkit: remove duplicate scalekit-code-doctor; point README to /saaskit:scalekit-code-doctor
- README: fix invalid install command syntax in plugin READMEs
- root README: add Windows install caveat

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- .mcp.json: replace mcp-remote with native HTTP MCP (type: http)
- session-management: scalekit.auth.* → scalekit.validateAccessToken/refreshAccessToken
- fastapi-reference: scalekit-sdk → scalekit-sdk-python, validate_access_token → validate_access_token_and_get_claims
- Setup skill: Claude Code → Codex platform reference
- Env var: SCALEKIT_ENV_URL → SCALEKIT_ENVIRONMENT_URL
…/Java SDK refs

- Strip .md suffix from docs.scalekit.com URLs
- SCALEKIT_ENV_URL → SCALEKIT_ENVIRONMENT_URL (50 remaining instances)
- Fix Python module shadowing in agentkit skills
- Fix Go SDK path to scalekit-inc/scalekit-sdk-go/v2
- Fix Java artifact to com.scalekit:scalekit-sdk-java
- Fix plugin.json homepage and websiteURL
…et_logout_url

- get_authorization_url: AuthorizationUrlOptions takes no constructor args
- get_logout_url: pass LogoutUrlOptions object, not dicts or bare kwargs
- fastapi-reference: fix wrong param name (access_token → id_token_hint)
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