Agentic Creator OS

Reusable skills, commands, agent profiles, and local safety tooling for AI-assisted creative work.

Quick start · Project instructions · Contributing · Issues

What this repository is

Agentic Creator OS (ACOS) is a public source repository for creator workflows that can be loaded into Claude Code or rendered as context for other coding agents. It contains:

• domain skills written as SKILL.md modules;
• top-level slash-command definitions for Claude Code;
• specialist agent profiles;
• local hook source and configuration;
• generators for Cursor, Windsurf, Gemini, Grok, Antigravity, and generic context files;
• MCP server workspaces and an observatory catalog.

ACOS is a source distribution, not a hosted service. The current version metadata is 11.0.0.

Verified public surface

The repository currently contains:

Surface	Count	Definition
Non-empty skill modules	175	Non-empty .claude/skills/**/SKILL.md files
Empty skill placeholders	5	Tracked SKILL.md paths with no content; not counted as modules
Top-level slash commands	85	.claude/commands/*.md, excluding the directory context file
Top-level agent profiles	81	.claude/agents/*.{md,json}, excluding the directory context file
Installable shell hooks	9	Top-level .claude/hooks/*.sh files copied by the Claude installer
Activation rules	32	Entries in .claude/skill-rules.json

These numbers are generated from the tree. npm run verify:public-surface fails if the counts, version metadata, install smoke test, or public license and marketplace statements drift.

Install from source

The verified installation path is the repository installer:

git clone https://github.com/frankxai/agentic-creator-os.git
cd agentic-creator-os
./install.sh --dry-run --platform=claude
./install.sh --platform=claude

--dry-run prints the files that would be created or replaced and writes nothing. The second command writes.

The Claude path copies the repository's skill groups, top-level commands, agent profiles, shell hooks, hook configuration, activation rules, and state metadata into CLAUDE_HOME (or ~/.claude by default).

Before installing into an existing profile, inspect the script and back up your profile. The Claude installer checks every file it would copy before writing anything: a differing file or symlinked destination stops the install instead of replacing your work. An unchanged repeat install skips identical files. It still writes ACOS-owned acos/state.json; there is no automatic uninstall or rollback yet. --target controls project files for other platforms, not the Claude profile path; set CLAUDE_HOME to choose an isolated Claude destination.

For an isolated inspection:

export CLAUDE_HOME="$(mktemp -d)"
./install.sh --platform=claude --minimal
find "$CLAUDE_HOME" -type f | sort

Other platform flags generate context or harness-specific files:

./install.sh --platform=cursor
./install.sh --platform=windsurf
./install.sh --platform=gemini
./install.sh --platform=grok
./install.sh --platform=antigravity
./install.sh --platform=generic

Those generators are present in the tree. They should not be read as a claim that every external harness or third-party connector has been independently certified end to end.