Workspaces & Roles
How Skilder organizes resources into workspaces with role-based access control, API keys, and team hierarchy.
Everything in Skilder lives inside a workspace — MCP servers, skills, hats, API keys, integrations, and AI provider configs.
Workspace Hierarchy
Members and Roles
Every workspace has members, each with a role that controls what they can do.
| Role | Capabilities |
|---|---|
| Admin | Full control. Manage members (invite, remove, change roles), configure MCP servers, create and edit skills, hats, API keys, integrations, and AI provider configs. |
| Editor | Create and edit skills, hats, and tools. Cannot manage members, API keys, or workspace settings. |
| Viewer | Use the Studio, browse skills and hats, view resources. Cannot modify anything. |
Invitations
Admins invite users by email with a role assignment (Admin, Editor, or Viewer).
- Invitations expire after 7 days.
- New users create an account when accepting. Existing users are added directly.
- Admins can revoke pending invitations from workspace member settings.
Core Resources
MCP Servers
Tool providers. Each server exposes one or more tools agents can call. Install from the registry or add custom configs. See Tools.
Skills
Bundle related tools with instructions, scripts, and assets. See Skills.
Hats
Group skills into role-based collections. Assign to API keys to control agent access. See Skills.
Organization Units
Hierarchical team structure (up to 10 levels) for organizing hats by department, team, or function. Manage from Organization Settings on the Hats page.
API Keys
| Key Type | Prefix | Scope |
|---|---|---|
| Workspace keys | WSK_ | Workspace scope. Created by admins in Workspace Settings > API Keys. |
| User keys | USK_ | User scope. Created from Profile > API Keys. Tied to your identity. |
Each key grants access through the hats in the workspace.
Integrations
OAuth connections to external services (Google, Microsoft, Zoho). Admins configure the provider; users connect personal accounts. See OAuth Integrations.
AI Provider Configs
Credentials and settings for AI model providers (Anthropic, OpenAI, etc.). See AI Providers.
Profile
Users manage personal settings from the Profile page (avatar menu, top-right):
| Tab | Purpose |
|---|---|
| Profile | Display name and password |
| API Keys | Personal user keys (USK_) |
| Integrations | Personal OAuth accounts |
| Connect | Device and agent connections |
How It All Fits Together
API Key → Workspace → Hats → Skills → Tools- Install MCP servers to bring tools into your workspace.
- Create skills that bundle the right tools for specific tasks.
- Organize skills into hats that represent roles.
- Generate API keys and assign hats.
- Connect your agent via MCP (STDIO or Streamable HTTP) — it discovers exactly the capabilities defined by its hat.