semantu-agents

Reusable Claude Code skills and hooks for Semantu projects.

Public skills are shipped with the npm package and work everywhere. Private skills require git access to the agents repo.

Project setup

npx semantu-agents

Syncs public skills from npm, tries to clone the agents repo for private skills (skips gracefully without access), patches package.json and .gitignore, and syncs all skills to .claude/skills/ and .agents/skills/.

Add to package.json so it runs on setup:

{
  "scripts": {
    "setup": "npx semantu-agents"
  }
}

Global setup

npx semantu-agents --global

Syncs skills to ~/.claude/skills/ and ~/.agents/skills/. This makes skills available to Claude Code and Codex across all projects without per-repo setup.

Editing skills

Edit directly in packages/semantu-agents/skills/, then commit and push:

cd packages/semantu-agents
git checkout -b my-change
# edit skills...
git add -A && git commit -m "improve workflow skill"
git push -u origin my-change

To re-sync after editing:

npm run sync:agents

Skill layout

skills/
  public/     # shipped on npm, always available
  private/    # git-clone only, requires repo access

Both are merged into the same flat .claude/skills/ directory at sync time.

Public skills

| Skill | Purpose | |---|---| | workflow | Enforces the mode cadence: ideation → plan → tasks → implementation → review → wrapup | | ideation | Interactively explore implementation options one decision at a time | | plan | Convert decisions into a concrete architecture plan | | tasks | Break a plan into phased tasks with validation criteria | | implementation | Execute tasks phase-by-phase with commits and validation | | review | Review work against intent, readiness, and gaps; triage iterate vs defer | | wrapup | Cleanup, changesets, and PR preparation | | automatic | Run the full workflow without manual mode transitions |