Agency Os

What it does

When your agent uses it

• Capturing chat to Notion
• Running the To-Do queue
• Discussing tasks
• Coordinating multi-task batches

Example prompts

• “/agency-os”
• “add a suggestion: …”
• “s discuss X”
• “/agency-os”

Requirements

• Python 3
• Node.js
• A credential in NOTION_TOKEN
• Compatibility (from SKILL.md): Designed for Claude Code; requires the Notion MCP server (@notionhq/notion-mcp-server) and a Notion workspace with a Tasks database
• Pre-approved tools (allowed-tools): Read, Write, Edit, Bash(python3:*), Bash(npx:*), Glob, Grep

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

1. 1Direct command invocation — /agency-os [args]. See
2. 2Natural-language driving — the skill translates conversational chat into
3. 3Batch execution — /agency-os run [--go] fans the entire To-Do queue

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Read
  • Write
  • Edit
  • Bash(python3:*)
  • Bash(npx:*)
  • Glob
  • Grep

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 1 file in scripts/ (Python), which the agent can run.

  Shell commands in SKILL.md call:

  • npx

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Links to these hosts (documentation or services it may open):

  • github.com
  • automatelab.tech

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • NOTION_TOKEN

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  Designed for Claude Code; requires the Notion MCP server (@notionhq/notion-mcp-server) and a Notion workspace with a Tasks database

  From compatibility in the SKILL.md frontmatter.

Context cost

Agency Os loads about 1.9k tokens when it runs, and up to ~17k if it reads all its reference files. Until then it costs about 160 tokens; SKILL.md has 675 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~160

When it runs · the whole SKILL.md, loaded when a task matches

~1.9k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~17k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NoteMentions a .env fileSKILL.md:61

  workspace. Add `.env` to `.gitignore` — never commit the token.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 675 words, ~1,871 tokens.

name

agency-os

description

Notion-as-source-of-truth dispatch board for running your work like an AI agency. One Tasks database is the source of truth; tasks flow Suggestion through Discussion, To-Do, In Progress, and Done with subtasks, recurring cadences, dependencies, and template subtrees. Batch execution fans approved To-Do rows out to parallel agents with per-task model selection. Use when capturing chat to Notion, running the To-Do queue, suggesting, approving, or discussing tasks, or coordinating multi-task batches. Trigger with "/agency-os" subcommands or natural-language variants ("add a suggestion: …", "let's discuss X", "run the queue").

allowed-tools

Read, Write, Edit, Bash(python3:*), Bash(npx:*), Glob, Grep

compatibility

Designed for Claude Code; requires the Notion MCP server (@notionhq/notion-mcp-server) and a Notion workspace with a Tasks database

version

0.2.0

author

ratamaha-git <ratamaha@automatelab.tech>

license

MIT

tags

ai-agency, notion, orchestration, mcp, dispatch, parallel-execution

ccpi install agency-os
# then in Claude Code:
/agency-os init --harness=basic --haiku=cost-tier --sonnet=default --opus=hard-reasoning

User: add a suggestion: refactor the auth flow to use the new token cache
Skill: → /agency-os suggest "refactor the auth flow to use the new token cache"
       ✅ Created Suggestion #t-2026-05-23-001 in corpus "platform"
       Next: /agency-os discuss t-2026-05-23-001

User: approve t-2026-05-23-{001..003} then run the queue
Skill: ✅ Approved 3 tasks → To-Do
       /agency-os run --go
       → fanning to 3 parallel agents...
       ✅ Done: 2 | ⚠️ Blocked on deps: 1 | Total spend: ~$0.04

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 11 other files (scripts, references) in skills/.curated/agency-os of jeremylongshore/tons-of-skills-marketplace.

• SKILL.md
• references/architecture.md
• references/commands.md
• references/config-template.json
• references/corpus-template.md
• references/general-guidance.md
• references/natural-language.md
• references/notion-pointers.json
• references/positioning.md
• references/task-page-template.md
• scripts/query-tasks.py
• state/.gitkeep

Open the folder on GitHubat commit cfae287