Skip to content

Consolidate 5 plugins into AgentKit + SaaSKit#7

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

Consolidate 5 plugins into AgentKit + SaaSKit#7
saif-at-scalekit wants to merge 49 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 (Go, FastMCP, Express, FastAPI).

Content improvements included

  • Renamed all skill frontmatter to match new plugin names
  • Removed beta SDK version pins (skill + agent)
  • Fixed broken CONNECTORS.md link
  • Fixed stale Reddit link in modular-sso
  • Fixed auth type claim in connector README

Supersedes #6.

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, FastMCP, Express, FastAPI
- 5 agents (deduplicated from originals)

Content improvements included:
- Renamed all skill frontmatter to match new plugin names
- Removed beta SDK version pins (SKILL.md + agent)
- Fixed broken CONNECTORS.md link
- Fixed stale Reddit link in modular-sso
- Fixed auth type claim in connector README

Supersedes #6.
… 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.
- Add install.sh bootstrap and scripts/install_copilot_marketplace.sh
- Handle migration from old v1.x plugin names
- Update README install section with new plugin names
…, google_slides)

Copilot had 39 connector docs while other auth stacks had 43.
Added the missing 4 to maintain parity.
Per-connector docs are unmaintainable — live AgentKit metadata and
docs.scalekit.com/agentkit/connectors/ are the source of truth.
- Rename agent files to *.agent.md (Copilot filename convention)
- Strip Claude-specific agent frontmatter (model, maxTurns, permissionMode, disallowedTools)
- Rename providers.md to connectors.md with full terminology rewrite
- Replace all Agent Auth references with AgentKit (27 occurrences across 9 files)
- Genericize Claude Desktop/Claude Code references to Copilot
- Fix stale integrating-agent-auth reference to integrating-agentkit
- Add tool-discovery.md to agentkit references
- Create hooks (hooks.json + beacon.sh) for both plugins
- Add testing-auth-setup skill to saaskit
- Remove testing-agentkit-tools and empty agents ref from agentkit plugin.json
- Add hooks field to both plugin.json manifests
- Plugin READMEs said 'into Codex' instead of 'into GitHub Copilot'
- AGENTS.md local testing and user install examples referenced old
  'mcp-auth' plugin name, updated to 'agentkit@github-copilot-authstack'
- Naming convention table updated to use current plugin/skill names
Main branch has 5 plugins (agent-auth, mcp-auth, full-stack-auth,
modular-sso, modular-scim). After merge, users with old install
commands would break.

Add symlinks so both old and new commands work:
  copilot plugin install agent-auth@github-copilot-authstack  (old)
  copilot plugin install agentkit@github-copilot-authstack    (new)

marketplace.json 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.
saif-shines and others added 21 commits May 20, 2026 14:16
- Fix email.split('@').toLowerCase() to email.split('@')[1].toLowerCase()
  in implementing-modular-sso so the domain part is extracted correctly.
- Replace absolute /agent-auth/connected-accounts URL with relative
  connected-accounts.md path in connections.md.
- Remove trailing stray backtick fence at end of implementing-modular-sso.
- Update README doc links to current paths (/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: scalekit -> scalekit-sdk-python (2 files),
  scalekit-sdk -> scalekit-sdk-python.
- Fix providers.md -> connectors.md in integrating-agentkit.
- 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 and full-stack auth references)
- Preserve GitHub Copilot platform swap in adding-mcp-oauth
- 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).
- 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 testing-auth-setup and scalekit-code-doctor skills

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>
- agentkit plugin.json: add setup skill, remove non-existent scalekit-code-doctor
- saaskit plugin.json: add setup skill
- Agent: frontmatter name scalekit-setup → setup-scalekit to match filename
- Setup skill: Claude Code → GitHub Copilot CLI platform reference
- .md URL suffix: fix homepage in plugin.json
…/Java SDK refs, LICENSE

- Strip .md suffix from docs.scalekit.com URLs
- SCALEKIT_ENV_URL → SCALEKIT_ENVIRONMENT_URL (46 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
- Add MIT LICENSE file
…et_logout_url

- get_authorization_url: pass AuthorizationUrlOptions object, not dict
- get_logout_url: pass LogoutUrlOptions object, not bare kwargs or dicts
Both methods use attribute access internally — dicts/kwargs crash at runtime.
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