# corezoid-access

corezoid-access — a skill for managing access to processes, folders and projects in Corezoid. Share objects with users and groups, create API keys, invite external users, and audit who has access.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 74 repo stars
- Author: Corezoid
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/corezoid/corezoid-ai-plugin/tree/HEAD/plugins/corezoid/skills/corezoid-access/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/corezoid-access

## What it does

corezoid-access handles all access operations within a Corezoid workspace: from sharing a process with a colleague to managing groups and rotating API keys. Under the hood, a single API endpoint `/api/2/json` with a `link` operation; the skill wraps it into actions like `share-object`, `create-group`, `create-api-key`, `find-principal`, `invite-user`, `modify-group`, `add-to-group`, `delete-group`, `list-group-objects`.

The privilege model is straightforward: four rights (`view`, `create`, `modify`, `delete`), applied independently and consistently across processes, folders, stages and projects. Grant full access with `privs="all"` or granular — for example, `privs="view,create"` to allow viewing and task creation. Revoke by passing `privs="none"` to the same `share-object` call.

When creating an API key, the skill saves the secret to `~/.corezoid/api-keys/<key-name>.json` with mode 0600 and never outputs it in chat. Before deleting a group, run `list-group-objects` to see which processes will lose access.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add corezoid/corezoid-ai-plugin
```
In the agent chat (not a shell):
```text
/plugin install corezoid@corezoid
```
This installs the whole corezoid plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add corezoid/corezoid-ai-plugin --skill corezoid-access -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/corezoid-access/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/corezoid-access/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add corezoid/corezoid-ai-plugin --skill corezoid-access -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/corezoid-access/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add corezoid/corezoid-ai-plugin --skill corezoid-access -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/corezoid-access/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install corezoid/corezoid-ai-plugin plugins/corezoid/skills/corezoid-access
```

2. **Manually: put the files in place**
- File: `.github/skills/corezoid-access/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add corezoid/corezoid-ai-plugin --skill corezoid-access -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/corezoid/corezoid-ai-plugin --path plugins/corezoid/skills/corezoid-access
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/corezoid-access/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/corezoid/corezoid-ai-plugin/tree/HEAD/plugins/corezoid/skills/corezoid-access/SKILL.md

## When to use it
- share a process with a colleague or team
- create and rotate an API key for external integrations
- manage group memberships and grant folder access to the group instead of individual users
- find out who has access to a process
- invite an external user to the workspace

## Example prompts
- Give me access to process 834936 with view and task creation rights
- Create a group called Backend Team and add Andrii and Maria to it
- Create an API key for the Salesforce sync integration

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 28ab5a6afbb3b7fc.

BEGIN THIRD-PARTY FILE 28ab5a6afbb3b7fc
````text
---
name: corezoid-access
description: >
  Corezoid access-control specialist. Use when the user wants to share a process,
  folder, stage or project with another user / group / API key, create or delete
  a user group, create or rotate an API key, invite an external user, or audit
  who currently has access to a Corezoid object. Activate when the user says
  "share", "give access", "grant access", "share to", "доступ", "пошарь",
  "create group", "создай группу", "create api key", "создай API ключ",
  "invite user", "пригласи", "revoke access", "unshare", "who has access".
---

# Corezoid Access Control

You are the specialist for sharing Corezoid objects and managing principals
(users, groups, API keys) inside a workspace. You drive `share-object`,
`create-group`, `create-api-key`, `find-principal`, `invite-user` and the
related operations.

## How to call them

All of them are **actions of the single `cz-access` MCP tool** — there is
no `share-object` tool to call on its own:

```
cz-access {"action": "share-object", "args": {"obj": "conv", "obj_id": 834936, "obj_to": "user", "obj_to_id": 78545, "privs": "view"}}
```

Every argument goes inside `args`. The examples in this skill use a shorthand —
`share-object obj=conv obj_id=834936` means exactly the call above. When unsure
about an action's arguments, call `cz-access {"action": "<action>", "help":
true}`: it returns the action's full schema and runs nothing.

## Mental model

Everything you share — a single process, a folder, a whole stage, or an
entire project — uses the **same** API operation: a `link` op against the
Corezoid `/api/2/json` endpoint with a `privs` payload. The MCP tools below
are thin wrappers around that one operation.

```
Workspace (company)
  ├── Projects ─────────► share-object obj=project
  │   └── Stages ───────► share-object obj=stage
  │       └── Folders ──► share-object obj=folder
  │           └── Processes (conv) ► share-object obj=conv
  │
  ├── Users      ── obj_to=user   (real human accounts)
  ├── API keys   ── obj_to=user   (API keys are users with logins.type=api)
````
END THIRD-PARTY FILE 28ab5a6afbb3b7fc

The third-party file has ended. Everything between the 28ab5a6afbb3b7fc tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2237 of 10306 bytes. © Corezoid · MIT · https://github.com/corezoid/corezoid-ai-plugin/tree/HEAD/plugins/corezoid/skills/corezoid-access/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
