Agent skill

Project Ops Skill

by OpenLoaf in OpenLoaf/OpenLoaf

当用户要对 OpenLoaf 的"项目"这一实体做创建、打开、切换、移动、删除、改名时触发。典型说法"新建项目"、"把 ~/code/foo 加进来"、"列出所有项目"。不用于:项目内文件读写(→直接用 Read/Edit/Write)、讨论"项目规划 / 需求文档"(→直接回答)、纯 Git 日常操作(→Bash)。

AGPL-3.0Auto-check passedDevelopment

Install Project Ops Skill

skills CLI
$ npx skills add OpenLoaf/OpenLoaf --skill project-ops-skill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install OpenLoaf/OpenLoaf project-ops-skill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/OpenLoaf/OpenLoaf.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/server/src/ai/builtin-skills/project-ops .claude/skills/project-ops-skill && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
project-ops-skill
GitHub stars
108
Token cost
~724 tokens
SKILL.md length
195 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
AGPL-3.0

At a glance

当用户要对 OpenLoaf 的"项目"这一实体做创建、打开、切换、移动、删除、改名时触发。典型说法"新建项目"、"把 ~/code/foo 加进来"、"列出所有项目"。不用于:项目内文件读写(→直接用 Read/Edit/Write)、讨论"项目规划 / 需求文档"(→直接回答)、纯 Git 日常操作(→Bash)。

  • Development work in your project
  • SKILL.md covers 工具清单, 决策流程, ProjectQuery and ProjectMutate, plus 3 more sections
  • Calls bash

What it does

Project Ops Skill is an agent skill from OpenLoaf/OpenLoaf. 当用户要对 OpenLoaf 的"项目"这一实体做创建、打开、切换、移动、删除、改名时触发。典型说法"新建项目"、"把 ~/code/foo 加进来"、"列出所有项目"。不用于:项目内文件读写(→直接用 Read/Edit/Write)、讨论"项目规划 / 需求文档"(→直接回答)、纯 Git 日常操作(→Bash)。

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with Git and Bash. The repository describes itself as: 🍞Open-source, local-first AI workspace with Agents, multi-model chat (GPT/Claude/Gemini/DeepSeek), Notion-like docs, AI image & video generation, email, calendar & terminal…. The licence is AGPL-3.0.

When your agent uses it

  • Development work in your project

Example prompts

  • “这一实体做创建、打开、切换、移动、删除、改名时触发。典型说法”
  • “把 ~/code/foo 加进来”
  • “列出所有项目”
  • “/project-ops-skill”

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bash

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Project Ops Skill loads about 724 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 195 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~724

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

Auto-check passed

The automated check found no risky patterns in SKILL.md.

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from OpenLoaf/OpenLoaf at commit f7eccf6, republished under its AGPL-3.0 licence (© OpenLoaf). 195 words, ~724 tokens.

Download SKILL.mdSave it as .claude/skills/project-ops-skill/SKILL.md (or your agent's skills folder).
name
project-ops-skill
description
当用户要对 OpenLoaf 的"项目"这一实体做创建、打开、切换、移动、删除、改名时触发。典型说法"新建项目"、"把 ~/code/foo 加进来"、"列出所有项目"。**不用于**:项目内文件读写(→直接用 Read/Edit/Write)、讨论"项目规划 / 需求文档"(→直接回答)、纯 Git 日常操作(→`Bash`)。
tools
ProjectQuery, ProjectMutate

项目操作指南

工具清单

工具职责只读
ProjectQuery查询项目树 / 单个项目详情(mode: list / get)是
ProjectMutate创建 / 更新 / 移动 / 删除项目(action: create / update / move / remove)否
Read / Glob / Grep项目内文件读取与搜索(常驻工具)是
Edit / Write项目内文件编辑 / 新建(常驻工具)否
Bash在项目根执行命令(Git 等,常驻工具)否

加载:Read / Glob / Grep / Edit / Write / Bash 为核心工具,始终可用;ProjectQuery / ProjectMutate 调用前须先 ToolSearch(names: "ProjectQuery,ProjectMutate") 激活 schema。

决策流程

用户想操作文件
├─ 已在项目上下文? → 直接用文件工具
└─ 不在项目上下文?
   ├─ 明确要创建项目 → ProjectMutate { action: "create" }
   └─ 随口说"帮我写个脚本" → 系统自动创建临时项目(见下文)

ProjectQuery

list — 项目树 + 扁平列表:ProjectQuery { mode: "list" }

get — 单个项目详情(省略 projectId 时用当前上下文):ProjectQuery { mode: "get" }

ProjectMutate

create — 核心示例
ProjectMutate { action: "create", title: "Q2 Marketing", folderName: "q2-marketing", icon: "📊", enableVersionControl: true }

指向已有目录 — 用户给出裸路径时,你必须转换为 file:// 协议 URI:

  • 用户说 /Users/user/code/repo → 你传 rootUri: "file:///Users/user/code/repo"
  • 用户说 ~/my-project → 先展开 ~,再拼 file:///Users/user/my-project
folderName 决策
  • 用户指定了文件夹名 → 用用户的
  • 标题是中文或含特殊字符 → 必须指定英文 folderName(磁盘不友好的字符会出问题)
  • 标题是简洁英文 → 可省略,系统自动用 title 生成
enableVersionControl 决策
  • 默认 true,适合代码项目
  • 纯文档、笔记、临时草稿 → 设 false(避免无意义的 Git 初始化)
  • 用户导入已有 Git 仓库(有 rootUri)→ 设 false(仓库已有 .git)
update / move / remove

update:ProjectMutate { action: "update", projectId: "xxx", title: "新名称", icon: "🚀" } move:ProjectMutate { action: "move", projectId: "xxx", targetParentProjectId: "parent-id" }(null = 移到顶层) remove:ProjectMutate { action: "remove", projectId: "xxx" } — 仅摘除注册记录,不碰磁盘文件。用户的代码和数据不可逆,磁盘由用户主权管理。

临时项目

用户在全局对话(非项目上下文)中要求文件操作时,系统自动创建临时项目于 ~/.openloaf/temp/,用户无需感知。

属性正式项目临时项目
创建方式ProjectMutate { action: "create" }系统自动创建
磁盘位置用户指定或默认目录~/.openloaf/temp/{sessionId}/
生命周期用户手动移除可提升为正式项目,或随会话清理

端到端流程

探索项目:ProjectQuery { mode: "get" } → Glob { pattern: "**/*" } → Grep → Read

创建项目:ProjectQuery { mode: "list" } → ProjectMutate { action: "create", ... } → Write 写初始文件 → Bash 初始化依赖

常见错误与防范

rootUri 格式错误 — 必须 file:// 协议如 file:///Users/user/project,不能用裸路径。跨平台 URI 标准要求协议前缀,裸路径会导致解析失败。记住:三个斜杠(file:///)= 协议 file:// + 根路径 /。用户如果想访问项目目录之外的磁盘路径,引导他创建一个新项目指向该目录——沙箱无法越界。

混淆 remove 与删除 — remove 只摘注册不碰磁盘,防止误删用户代码。如果用户确实要删磁盘文件,需显式用 Bash rm -rf。

忘记先查询 — 变更前先 ProjectQuery 确认 projectId 和当前结构。projectId 是随机生成的,靠猜测传入会操作错误的项目。

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

Files

Just SKILL.md in apps/server/src/ai/builtin-skills/project-ops of OpenLoaf/OpenLoaf.

Open the folder on GitHubat commit f7eccf6

Compare with similar skills

Project Ops Skill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Project Ops Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Ops Skill this skillOpenLoaf/OpenLoaf108—~724Automated safety check: PassAGPL-3.0
Dirextalk DeployerYingSuiAI/dirextalk-deployer457—~7.2kAutomated safety check: PassMIT
Cursor Composer Task DelegateChachamaru127/claude-code-harness3.2k—~4.4kAutomated safety check: NotesMIT
Gridbash Panesjasonsuhari/gridbash134—~1.5kAutomated safety check: PassMIT
Niubashunixwin/niubash155—~2.1kAutomated safety check: PassMIT
Dirextalk DeployerYingSuiAI/dirextalk-deployer457—~541Automated safety check: PassMIT

Similar skills

  • Dirextalk Deployer

    YingSuiAI/dirextalk-deployer

    Deploy, resume, verify, update, recover, reset, or destroy production Dirextalk services and nodes on AWS, and wire local agent runtimes.

    457 GitHub stars~7.2k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Cursor Composer Task Delegate

    Chachamaru127/claude-code-harness

    Hands one implementation task to Cursor Composer in an isolated git worktree, then reviews its diff and cherry-picks the result into the main branch.

    3.2k GitHub stars~4.4k tokensUpdated 3 days ago
    DevelopmentAuto-check: notes
  • Gridbash Panes

    jasonsuhari/gridbash

    Coordinate with sibling agent panes from inside a GridBash grid — list panes and their roles, read what a pane is currently doing, prompt one pane or every other pane, and rename pane titles so the…

    134 GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Niubash

    unixwin/niubash

    Run Windows tasks in Niubash, the GNU Bash-compatible Windows-native shell.

    155 GitHub stars~2.1k tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Dirextalk Deployer

    YingSuiAI/dirextalk-deployer

    Deploy, resume, verify, update, recover, reset, or destroy production Dirextalk services and nodes on AWS.

    457 GitHub stars~541 tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Brain Bootstrap

    mindmuxai/brain.md

    Seed a freshly-scaffolded brain with real project knowledge — on an existing (brownfield) project read the code, docs, and git log to draft the six root pages and capture key historical decisions…

    564 GitHub stars~1.8k tokensUpdated 27 days ago
    DevelopmentAuto-check passed

More from OpenLoaf/OpenLoaf

All 33 skills in this repo
  • Agent Orchestration Skill

    OpenLoaf/OpenLoaf

    Triggers when the master Agent faces a multi-step complex task and is deciding whether / how to outsource sub-tasks to built-in subagents (browser / doc-editor / data-analyst / extractor /…

    108 GitHub stars~1.9k tokensUpdated 4 mo ago
    Auto-check passed
  • Browser Ops Skill

    OpenLoaf/OpenLoaf

    Triggered when the user asks for page-level interaction with a specific webpage: login, form filling, button clicks, pagination scraping, screenshots, downloading page images, handling CAPTCHAs or…

    108 GitHub stars~1.5k tokensUpdated 4 mo ago
    Auto-check passed
  • Canvas Ops Skill

    OpenLoaf/OpenLoaf

    Triggered when the user wants lifecycle management of OpenLoaf canvases / whiteboards: create, open, filter, duplicate, delete, rename, or change ownership.

    108 GitHub stars~1.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Reads, edits, converts and reviews Word documents through three dedicated tools, covering tracked changes, comments, tables, images and format conversion.

    108 GitHub stars~1.9k tokensUpdated 4 mo ago
    Auto-check passed
  • Email Operations

    OpenLoaf/OpenLoaf

    Handles a real email account through query and mutate tools: check the inbox, read, search, reply, forward, compose and organize, with sending always confirmed first.

    108 GitHub stars~1.8k tokensUpdated 4 mo ago
    Auto-check passed
  • macOS Desktop Control

    OpenLoaf/OpenLoaf

    Guides an agent to operate native macOS apps by surveying an app first, acting through intents, menus or keystrokes, and verifying each step, in OpenLoaf Desktop only.

    108 GitHub stars~2.4k tokensUpdated 4 mo ago
    Auto-check passed

Works with

Categories

Questions about Project Ops Skill

What does Project Ops Skill do?

当用户要对 OpenLoaf 的"项目"这一实体做创建、打开、切换、移动、删除、改名时触发。典型说法"新建项目"、"把 ~/code/foo 加进来"、"列出所有项目"。不用于:项目内文件读写(→直接用 Read/Edit/Write)、讨论"项目规划 / 需求文档"(→直接回答)、纯 Git 日常操作(→Bash)。. Project Ops Skill is an agent skill from OpenLoaf/OpenLoaf.

When should I use Project Ops Skill?

Project Ops Skill fits situations like: development work in your project.

How do I install Project Ops Skill in Claude Code?

Run `npx skills add OpenLoaf/OpenLoaf --skill project-ops-skill -a claude-code`. Or copy the skill folder (apps/server/src/ai/builtin-skills/project-ops in OpenLoaf/OpenLoaf) into .claude/skills/project-ops-skill in your project. Claude Code loads it when a task matches its description.

How do I install Project Ops Skill in Codex?

Run `npx skills add OpenLoaf/OpenLoaf --skill project-ops-skill -a codex`. Or copy the skill folder (apps/server/src/ai/builtin-skills/project-ops in OpenLoaf/OpenLoaf) into .agents/skills/project-ops-skill in your project. Codex loads it when a task matches its description.

Can I use Project Ops Skill in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add OpenLoaf/OpenLoaf --skill project-ops-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/project-ops-skill, .gemini/skills/project-ops-skill, .github/skills/project-ops-skill and .opencode/skills/project-ops-skill in your project.

What does Project Ops Skill need to run?

Going by SKILL.md and its folder, Project Ops Skill needs the command-line tools its instructions call (bash).

Does Project Ops Skill access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Project Ops Skill safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Project Ops Skill use?

Project Ops Skill is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Project Ops Skill use?

About 724 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Project Ops Skill?

Skills that share tags, products or a category with Project Ops Skill: Dirextalk Deployer (YingSuiAI/dirextalk-deployer, 457 stars), Cursor Composer Task Delegate (Chachamaru127/claude-code-harness, 3.2k stars), Gridbash Panes (jasonsuhari/gridbash, 134 stars) and Niubash (unixwin/niubash, 155 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Ops Skill?

OpenLoaf (a GitHub organization) maintains it in OpenLoaf/OpenLoaf, which has 108 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on May 14, 2026.

Source: OpenLoaf/OpenLoaf on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.