agentleFS
celeryhqceleryhq/simplified-ai/skills/simplified-workspace/SKILL.md

simplified-workspace

Skill4 starsChanged 4 months agoMITView on GitHub

Identify the authenticated Simplified user and workspace, inspect workspace settings, and discover or resolve accessible teamspaces safely. Use when the user asks "who am I," which Simplified workspace or teamspace is connected, what teamspaces they can access, which timezone or language applies, or asks to work in a named teamspace before using assets, brands, projects, social accounts, drafts, or other workspace-scoped resources.

The file

We split this skill into the rules it gives an agent

11 rules. About 0 are common, 4 are distinctive, and 7 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 7

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Call api_getWorkspaceInfo for the authenticated user's identity, current workspace, workspace settings, and visible active teamspaces.

    line 12
  2. Very specific:

    Call api_listTeamspaces to discover the current user's accessible memberships, including all relevant pages.

    line 14
  3. Very specific:

    If the user names a teamspace, search with api_listTeamspaces.

    line 18
  4. Very specific:

    If deeper workspace metadata is material, call api_getWorkspace with the workspace integer ID returned by api_getWorkspaceInfo.

    line 19
  5. Very specific:

    When the user says “use,” “push this to,” “create in,” or “switch to” a teamspace, remember the resolved ID for the current task and pass …

    line 20
  6. Distinctive:

    Follow references/teamspace-context.md before handing off to another Simplified skill.

    line 22
  7. Very specific:

    Treat api_getWorkspaceInfo as Simplified's authoritative whoami.

    line 26
  8. Distinctive:

    Do not reuse IDs for accounts, assets, brand kits, projects, items, drafts, or posts across teamspaces without re-listing them in the …

    line 41
  9. Very specific:

    Never omit space_id midway through a scoped workflow.

    line 42
  10. Distinctive:

    When another skill will continue the work, provide a compact context block:

    line 53
  11. Distinctive:

    Do not treat context resolution as permission to generate credits, edit brand memory, mutate projects, schedule, queue, or publish.

    line 61

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Simplified Workspace

Establish the correct Simplified identity and workspace context before operating on scoped resources. This operator resolves a teamspace once, then scopes every downstream MCP call explicitly.

Workflow

  1. Call api_getWorkspaceInfo for the authenticated user's identity, current workspace, workspace settings, and visible active teamspaces. Its teamspaces field is context information, not membership authority.
  2. Call api_listTeamspaces to discover the current user's accessible memberships, including all relevant pages. Use search for name matching and expand:"settings" when settings are needed. Return available teamspaces from this membership list, not from api_getWorkspaceInfo.teamspaces.
  3. If the user names a teamspace, search with api_listTeamspaces. Resolve to one exact numeric ID; do not guess when names or slugs are ambiguous.
  4. If deeper workspace metadata is material, call api_getWorkspace with the workspace integer ID returned by api_getWorkspaceInfo.
  5. When the user says “use,” “push this to,” “create in,” or “switch to” a teamspace, remember the resolved ID for the current task and pass space_id: <numeric_id> on every downstream Simplified tool call.
  6. State the applied context before the downstream workflow: user, workspace, teamspace name and ID, and settings that affect the work.
  7. Follow references/teamspace-context.md before handing off to another Simplified skill.

Identity and memory model

  • Treat api_getWorkspaceInfo as Simplified's authoritative whoami; never infer identity from conversation memory.
  • A credential belongs to one workspace. Teamspaces are sub-spaces inside that workspace, not alternate workspaces.
  • Brand kits and their context documents are durable Simplified marketing memory. Workspace identity decides where that memory is read or written; this skill does not replace manage-brand.
  • Conversation memory is not proof that a remote workspace, teamspace, account, asset, brand kit, project, or draft still exists or remains accessible. Re-read context when the user changes client, workspace, or teamspace, or before a consequential write when context is uncertain.
  • Workspace timezone, language, and start of week guide planning. For social scheduling, inspect workspace settings and account metadata; the create tool accepts no timezone field. Canonical guidance identifies workspace timezone, but resolve conflicting service/account interpretation before converting a user-specified time. Disclose uncertainty rather than scheduling at an assumed time.

Teamspace safety

  • Teamspace IDs are integers. Never pass a name, slug, alias, or fabricated value where a numeric ID is required.
  • Hosted MCP scoping is stateless: space_id applies to one tool call. Carry the same resolved ID into every related read, write, poll, and follow-up call for the current task.
  • It is fine to tell the user “Using Acme East (42)” after resolution, but do not imply the server persisted a global teamspace:use session.
  • Do not reuse IDs for accounts, assets, brand kits, projects, items, drafts, or posts across teamspaces without re-listing them in the correctly scoped context.
  • Never omit space_id midway through a scoped workflow. An omitted value uses the configured inbound Space header or server fallback scope when present, otherwise the credential's default workspace context. It does not reliably preserve the task's explicitly selected teamspace.
  • On 403, report the denied operation and inspect whether access or permission is missing. On 400, read the actual validation error: it may concern a payload field rather than teamspace scope. Preserve the selected scope while correcting invalid fields. Never retry against a different space without the user's direction.

Handoff contract

When another skill will continue the work, provide a compact context block:

  • authenticated user;
  • workspace name and integer ID;
  • requested teamspace name and integer ID, or default workspace context;
  • workspace timezone/language/start-of-week when relevant;
  • the space_id that every downstream Simplified call must carry.

Do not treat context resolution as permission to generate credits, edit brand memory, mutate projects, schedule, queue, or publish.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.