Project Butler

Project memory workflow for init/upgrade, profile-aware setup, end session, normal/full close, file organization, document archiving, language switching, versioned update logs, rule review, status, wiki sync, and context recovery. Use for /project-butler, setup/初始化, foundation setup, profile setup, end session/收工, normal close, full close, foundation repair, organize files/整理文件, change language/切换语言, continue/接着上次, continue full context/全面回顾, review claude, sync wiki, status. Maintains project memory files. Runs version freshness check before trigger routing.

374 stars 12 forksProductivity & Notes

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add JamesShi96/project-butler --skill project-butler
Manual install
git clone --depth 1 https://github.com/JamesShi96/project-butler.git /tmp/project-butler
mkdir -p ~/.claude/skills
cp -r /tmp/project-butler/. ~/.claude/skills/project-butler

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Project Butler — Project Memory Stack

Initialize standardized project memory:

```
上层(稳定原则)
┌─────────────────────────────────────┐
│  CLAUDE.md(项目宪法)← 人工确认     │
│  ↑ candidates(AI 自动收集候选)     │
└─────────────────────────────────────┘
        ↑ 抽象沉淀
中层(当前快照)
┌─────────────────────────────────────┐
│  PROJECT.md(项目 Wiki)← AI 自动同步 │
│  概览 / 结构 / 模块状态 / 文件索引    │
│  STRUCTURE.md(文件管理规则)← AI 自动│
│  目录规则 / 匹配条件 / 整理历史       │
│  UPDATE_LOG.md(里程碑变化)← AI 自动 │
│  DOCS.md(文档索引 + 元数据)← AI 自动 │
│  .claude/project-profile.json(画像配置)│
│  .claude/profile-pending.json(画像待处理)│
└─────────────────────────────────────┘
        ↑ 状态汇总
下层(事实流水)
┌────────────────────┐  ┌────────────────────┐
│  log/(会话日志)   │  │  TODO.md(执行清单)│
│  raw + summaries   │  │  owner/deadline/    │
│  + archive(分级)  │  │  deps               │
└────────────────────┘  └────────────────────┘
        ↓
session-handoff.md(下次接手点)
```

Core idea: bottom feeds top, top constrains bottom. Logs and TODOs are raw facts. Handoff marks the next resume point. Wiki is the current snapshot. Structure manages file organization. Docs index manages document output. Update Log records versioned milestone changes. Constitution is stable principles.

Supports 3 language modes: English (`en`), Chinese (`zh`), or bilingual. All content adapts to the selected language.

---

## Step -1: Version Freshness Check (always run first)

<EXTREMELY_IMPORTANT>
Before any other step, read `references/update-check.md` and execute
Read the full skill on GitHub

Details

Skill name
project-butler
License
MIT
Repo updated
29 July 2026

FAQ

What does the Project Butler skill do?

Project memory workflow for init/upgrade, profile-aware setup, end session, normal/full close, file organization, document archiving, language switching, versioned update logs, rule review, status, wiki sync, and context recovery. Use for /project-butler, setup/初始化, foundation setup, profile setup, end session/收工, normal close, full close, foundation repair, organize files/整理文件, change language/切换语言, continue/接着上次, continue full context/全面回顾, review claude, sync wiki, status. Maintains project memory files. Runs version freshness check before trigger routing.

How do I install the Project Butler skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add JamesShi96/project-butler --skill project-butler. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Project Butler popular?

It lives in JamesShi96/project-butler, which has 374 GitHub stars and 12 forks.

Related skills

Readable Verilog Generator

326

Eriemon/verilog-generator

Use when creating, writing, reviewing, annotating, repairing, refactoring, or validating readable Verilog RTL, including synthesizable Verilog-2001 .v files, existing-RTL analysis, semantic comment annotation, testbench scaffold planning, ASIC-quality review, local or remote Vivado/xsim validation, evidence-backed repair, and workflow trace diagnosis.

Productivity & Notes23

Atomicmail

268

Atomic-Mail/atomic-mail-agentic

Read and write email through the Atomic Mail from an AI agent. Handles proof-of-work authentication and JMAP so the agent thinks in JMAP method calls. Use when the user asks to register an email inbox, list mailboxes, fetch or send email.

Productivity & NotesIn 1 list64

Codex Workflows

328

scasella/claude-dynamic-workflows-codex

Run a dynamic-workflow script on a local Codex App Server — orchestrate many Codex / GPT agents (the agent / parallel / pipeline / phase / budget DSL) instead of Claude subagents, for codebase audits, large migrations, and multi-agent review or research. Give it one or two rough sentences and it compiles the right harness for you; add --multi for a supervised fleet of concurrent workflows. Manual-invoke only via /codex-workflows.

Productivity & Notes15

Resend

208

resend/resend-skills

Use when working with the Resend email API — sending transactional emails (single or batch), receiving inbound emails via webhooks, managing email templates, tracking delivery events, managing domains, contacts, broadcasts, webhooks, API keys, inboxes (threads, labels, drafts, replies), automations, events, viewing API request logs, checking account usage and quotas, or setting up the Resend SDK. Always use this skill when the user mentions Resend, even for simple tasks like "send an email with Resend" — the skill contains critical gotchas (idempotency keys, webhook verification, template vari

Productivity & NotesIn 2 lists34

Linear

139

wrsmith108/linear-claude-skill

Managing Linear issues, projects, and teams. Use when working with Linear tasks, creating issues, updating status, querying projects, or managing team workflows.

Productivity & NotesIn 3 lists14

Email Best Practices

208

resend/resend-skills

Use when building email features, emails going to spam, high bounce rates, setting up SPF/DKIM/DMARC authentication, implementing email capture, ensuring compliance (CAN-SPAM, GDPR, CASL), handling webhooks, retry logic, making emails accessible (alt text, headings, contrast, screen readers), or deciding transactional vs marketing.

Productivity & NotesIn 2 lists34

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.