AI Skill

Claude Agency + Workspace Skill

A specialized AI skill that gives Claude/ChatGPT/Cursor expert-level intuition for CodivUpload's agency stack — multi-tenant workspaces, role-based access (Admin / Editor / Viewer), branded team invites via Resend, whitelabel branded OAuth flows, profile move between workspaces, and the billing cascade model where one Stripe subscription scales to every workspace owned by the same user.

All — agency-level operations

Best for:Agency owners, SaaS builders integrating CodivUpload as a backend, anyone managing 5-200+ client social media accounts.

Install MCP serverAll skills

What this skill teaches the LLM

The skill is a markdown file the LLM reads when activating. Below is the focused context this skill bakes in — so Claude/ChatGPT/Cursor doesn't have to learn from API errors.

  • Three nested concepts: Workspace > Profile > Connected accounts. Plus team members per-workspace.
  • Plan-tier limits memorized: Free=1ws/1seat/2profiles, Starter=2/1/10, Pro=5/3/25, Business=15/5/75, Enterprise=∞/25/250+
  • Counts are GLOBAL across all owned workspaces (3 profiles in WS-A + 7 in WS-B = 10 toward plan cap)
  • Role hierarchy: Admin (full), Editor (compose+publish, no billing/invites), Viewer (read-only)
  • Roles are per-workspace — same user can be Admin in WS-A and Viewer in WS-B
  • Invite flow: existing user → instant add. New user → branded email via Resend (Pro+ branded with agency logo) → /auth/invite?token=xxx → auto-create account + join workspace
  • Cycle prevention: workspace owner cannot be invited as member of another workspace (returns 400 owner_cycle_prevented)
  • Billing cascade: primary workspace carries Stripe subscription, plan upgrades cascade to all owned workspaces immediately
  • Soft-delete: deleted workspace data preserved 30 days for accidental-deletion recovery
  • Whitelabel branded OAuth: Pro+ unlocks logo + colors + agency name on connect pages, optional custom domain proxy

Example prompts

These are real prompts you can give an AI client with this skill installed. The skill provides the LLM with the right tool calls, parameter names, and platform-specific quirks so the response is correct on the first try.

1

“Create a new client workspace for Acme Corp and invite their account manager as Admin.”

What the LLM does

Claude calls create_profile with username='acme_corp', then sends Admin invite to the client's email. Existing user → instant add. New user → branded invite email.

2

“Show me which workspaces are owned by the current user and what each one's monthly post count is.”

What the LLM does

Claude calls list_workspaces + per-workspace get_analytics. Aggregates results into a portfolio view.

3

“Move the 'BloomSkincare' profile from Workspace-A to Workspace-B — same client just reorganizing.”

What the LLM does

Claude calls move_profile, explains that post history follows the profile (nothing lost), only parent workspace changes.

Install in 2 steps

The skill itself is a markdown file. The MCP server is the runtime. Install both for the full experience.

  1. 1Configure MCP server in your AI client

    Paste this configuration into Claude Desktop / Cursor / Zed's MCP config file. Replace cdv_your_api_key with your real key from pricing.

    {
  "mcpServers": {
    "codivupload": {
      "command": "npx",
      "args": ["-y", "codivupload-mcp"],
      "env": {
        "CODIVUPLOAD_API_KEY": "cdv_your_api_key"
      }
    }
  }
}

  2. 2Add the skill markdown

    Download npmjs/skills/agency/SKILL.md from the GitHub repo and place it under ~/.claude/skills/codivupload-agency/SKILL.md (Claude Desktop) or your project's .claude/skills/ directory.

    For ChatGPT: paste the SKILL.md content into a Custom GPT's Instructions field at gpts.openai.com/editor.

    github.com/Codivion

Frequently asked

Will my team members see other clients' data?+

No — workspace membership is granular. A team member only sees workspaces explicitly invited to. The skill teaches Claude to enforce this isolation when answering team-management questions.

How does the billing cascade work?+

The user's primary workspace carries the Stripe subscription. Every additional workspace they own inherits the plan tier automatically. No separate billing page per workspace. Plan upgrades cascade to all owned workspaces immediately.

Are invite emails branded with my agency name?+

Pro plan and above — yes. Email shows your agency's logo, colors, inviter name. From address remains no-reply@email.codivupload.com but visible content is fully whitelabeled. Free/Starter use default CodivUpload-branded email.

Can the skill help me build a whitelabel SaaS on top of CodivUpload?+

Yes — covers the three patterns: pure API integration (your UI on top of CodivUpload's REST API), hybrid (API + dashboard for staff), and white-labeled OAuth (clients connect their own accounts via your branded flow). Plus the agency_profiles model for per-customer isolation.

Related skills

CodivUpload Generic Skill

Generic AI skill for Claude Desktop, Claude Code, ChatGPT Pro, Cursor, Zed. Covers all 11 social platforms via MCP server. Anthropic Skills format, MIT licensed.

Ready to give your AI agent posting tools?

Free CodivUpload plan covers 30 posts/month. Skills are MIT licensed.

Get an API key