Admin Guide

This guide covers organization management, billing, analytics, and platform administration features for team leads and global admins.

Organization Settings

Access organization settings from Settings → Organization. The settings page has tabs for Profile, Usage, and Connections.

On the Profile tab, you can edit your organization's display name and slug. Changing the slug will create a redirect from the old URL so existing links continue to work.

Member Management

Organizations support multiple members through the UserOrganization relationship. From the Members section, you can:

• View all current members and their roles
• Remove members from the organization
• Invite new members by email

Members share access to all org-visibility resources and the organization's credit pool.

Invitations

Send email invitations to bring new members into your organization. Invitations are sent through the Resend email service and include a link to accept and join. You can:

• View pending invitations
• Resend invitations that may have been missed
• Track invitation status (pending, accepted, expired)

Slugs & Public URLs

Your organization's slug determines its public URL: app.sharedcontext.ai/{your-slug}. This URL serves as your organization's profile page, listing all published skills.

Slugs must be lowercase, alphanumeric with hyphens, and globally unique. Certain slugs are reserved (e.g., admin, api, settings, github). When you rename a slug, a redirect is automatically created from the old URL.

Published skills get canonical URLs in the format: app.sharedcontext.ai/{org-slug}/skills/{skill-slug}.

Plans & Credits

Shared Context uses a credit-based billing system. Credits are consumed when users execute skills against AI models. The platform offers:

• Individual tier — A personal credit allocation
• Team tier — A shared credit pool for the organization, managed through Stripe subscriptions

Upgrade your plan through the Billing page, which integrates with Stripe Checkout. Once subscribed, manage your subscription through the Stripe Customer Portal.

Usage Monitoring

The Usage tab in Settings shows a breakdown of credit consumption by model, including token counts and run counts. This helps you understand which models and skills are consuming the most resources.

Credit Expansions & Overage

If your team needs more credits than the plan provides, you have two options:

• Credit expansions — Purchase additional credit blocks at a set price
• Overage pricing — Pay-as-you-go for usage beyond your plan's limits

Visibility Control

As an org admin, be aware that resource visibility affects what your team and the public can see:

• Resources set to org are visible to all members but not the public
• Resources set to published appear in the public library and on your org profile page
• Shared resources (public_link) are accessible to anyone with the URL but aren't discoverable

The resource author controls visibility. There is no organization-level override for individual resource visibility.

Managing Adoptions

When team members install skills from other organizations, adoption records are created automatically. As an admin, you can:

• View all adopted skills for your organization
• Review adoption status (active, pending review, revoked)
• Pin specific versions of adopted skills to prevent unwanted updates
• Revoke adoptions to remove cross-org skill access

Connections Overview

Connections are per-user (not per-org), but you can view connection activity across your organization through the Settings → Connections tab. This shows which platforms your team members have connected and the overall installation activity.

Organization Analytics

The organization analytics dashboard (/analytics) shows aggregate metrics for your workspace:

• Total usage (runs, tokens consumed, credits spent)
• Top resources by execution count
• Most active users
• Usage trends over time

User Analytics

Individual user profiles include analytics for their contributions: skills created, runs executed, stars received, and activity history.

Global Admin Panel

The admin panel at /admin provides platform-wide management tools organized into tabs:

Organizations Tab

View all organizations on the platform with stats (member count, file count, monthly runs, plan type, credit balance). Search and filter organizations, and manually add credits to any org's balance.

Events Log Tab

An aggregated activity feed showing platform-wide events: signups, skill executions, stars, clones, credit transactions, and more. Each event includes the actor, target, and timestamp. Paginated for browsing through history.

Analytics Tab

Platform-level KPIs, growth metrics, and a conversion funnel tracking the journey from landing page visit to signup to first execution to paid upgrade.

GitHub Skills Curation

The GitHub tab in the admin panel lets platform admins curate skills from public GitHub repositories:

• Import — Provide a GitHub URL, and the system auto-extracts owner, repo, path, ref, and skill metadata from the SKILL.md content
• List & manage — View all GitHub-sourced skills with sync status and timestamps
• Force sync — Manually refresh a skill from its GitHub source (normally auto-synced every 24 hours)
• Publisher profiles — Each GitHub owner gets an ExternalPublisher profile with name and avatar, displayed on their publisher page at /external/{owner}

Events Log

The platform emits typed events for key actions that feed into the admin events log. Event types include:

• resource.created, resource.updated, resource.deleted
• skill.installed, skill.updated, skill.uninstalled
• skill.adopted, skill.unadopted
• connection.created, connection.deleted

Events are fire-and-forget and used for analytics and audit purposes.

Platform Analytics

The platform analytics dashboard tracks high-level business metrics:

• Total users, organizations, and resources
• Growth rates (daily, weekly, monthly signups)
• Conversion funnel: landing page → signup → first run → upgrade
• Revenue metrics from Stripe subscriptions
• Page view tracking for funnel analysis