Agent skill

Project Ops Skill

by OpenLoaf in OpenLoaf/OpenLoaf

Triggered when the user wants to create, open, switch, move, delete, or rename OpenLoaf's "project" entity.

AGPL-3.0Auto-check passedProduct & Project Management

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/en .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
107
Token cost
~1.3k tokens
SKILL.md length
515 words
Files
1
Skills in repo
34
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Triggered when the user wants to create, open, switch, move, delete, or rename OpenLoaf's "project" entity.

  • Wants to create
  • SKILL.md covers Tool Inventory, Decision Flow, ProjectQuery and ProjectMutate, plus 3 more sections
  • Calls bash
  • Rename OpenLoafs project entity

What it does

Project Ops Skill is an agent skill from OpenLoaf/OpenLoaf. Triggered when the user wants to create, open, switch, move, delete, or rename OpenLoaf's "project" entity. Typical phrasings: "new project", "add ~/code/foo", "list all projects". Not for: reading/writing files inside a project (→ use Read/Edit/Write directly), discussing "project planning / requirement docs" (→ answer directly), routine Git operations (→ Bash).

Its SKILL.md is about 1.3k 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 Product & Project Management, covering Project management. 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

  • Wants to create
  • Rename OpenLoafs project entity

Example prompts

  • “project”
  • “new project”
  • “add ~/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 1.3k tokens when it runs. Until then it costs about 97 tokens; SKILL.md has 515 words of instructions outside code blocks.

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

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). 515 words, ~1,278 tokens.

Download SKILL.mdSave it as .claude/skills/project-ops-skill/SKILL.md (or your agent's skills folder).
name
project-ops-skill
description
Triggered when the user wants to create, open, switch, move, delete, or rename OpenLoaf's "project" entity. Typical phrasings: "new project", "add ~/code/foo", "list all projects". **Not for**: reading/writing files inside a project (→ use Read/Edit/Write directly), discussing "project planning / requirement docs" (→ answer directly), routine Git operations (→ `Bash`).

Project Operations Guide

Tool Inventory

ToolResponsibilityRead-only
ProjectQueryQuery project tree / single project details (mode: list / get)Yes
ProjectMutateCreate / update / move / delete projects (action: create / update / move / remove)No
Read / Glob / GrepRead and search files within a project (always available)Yes
Edit / WriteEdit / create files within a project (always available)No
BashRun commands at the project root (Git, etc., always available)No

Loading: Read / Glob / Grep / Edit / Write / Bash are core tools and always available; ProjectQuery / ProjectMutate must be activated with ToolSearch(names: "ProjectQuery,ProjectMutate") before calling to load their schemas.

Decision Flow

User wants to operate on files
├─ Already in a project context? → Use file tools directly
└─ Not in a project context?
   ├─ Explicitly wants to create a project → ProjectMutate { action: "create" }
   └─ Casual "help me write a script" → System auto-creates a temporary project (see below)

ProjectQuery

list — Project tree + flat list: ProjectQuery { mode: "list" }

get — Single project details (omit projectId to use the current context): ProjectQuery { mode: "get" }

ProjectMutate

create — Core Example
ProjectMutate { action: "create", title: "Q2 Marketing", folderName: "q2-marketing", icon: "📊", enableVersionControl: true }

Pointing to an existing directory — When user provides a bare path, you must convert it to a file:// protocol URI:

  • User says /Users/user/code/repo → you pass rootUri: "file:///Users/user/code/repo"
  • User says ~/my-project → first expand ~, then build file:///Users/user/my-project
folderName Decision
  • User specified a folder name → use the user's
  • Title is in Chinese or contains special characters → must specify an English folderName (disk-unfriendly characters cause problems)
  • Title is concise English → can be omitted; the system auto-generates from the title
enableVersionControl Decision
  • Default true, suitable for code projects
  • Pure docs, notes, temporary drafts → set false (avoid meaningless Git init)
  • User is importing an existing Git repo (has rootUri) → set false (repo already has .git)
update / move / remove

update: ProjectMutate { action: "update", projectId: "xxx", title: "New Name", icon: "🚀" } move: ProjectMutate { action: "move", projectId: "xxx", targetParentProjectId: "parent-id" } (null = move to top level) remove: ProjectMutate { action: "remove", projectId: "xxx" } — only unregisters the record, does not touch files on disk. The user's code and data are irreversible; disk contents are under the user's sovereignty.

Show full SKILL.md (227 more words)Show less

Temporary Projects

When a user requests file operations in a global conversation (not a project context), the system automatically creates a temporary project under ~/.openloaf/temp/, transparent to the user.

AttributeFormal ProjectTemporary Project
CreationProjectMutate { action: "create" }Auto-created by the system
Disk locationUser-specified or default directory~/.openloaf/temp/{sessionId}/
LifecycleManually removed by userCan be promoted to formal project, or cleaned up with the session

End-to-End Flows

Exploring a project: ProjectQuery { mode: "get" } → Glob { pattern: "**/*" } → Grep → Read

Creating a project: ProjectQuery { mode: "list" } → ProjectMutate { action: "create", ... } → Write initial files → Bash to install dependencies

Common Mistakes and Guardrails

Malformed rootUri — Must use the file:// protocol, e.g., file:///Users/user/project; bare paths are not allowed. The cross-platform URI standard requires the protocol prefix; bare paths will fail to parse. Remember: three slashes (file:///) = protocol file:// + root path /. If the user wants to access a disk path outside the project directory, guide them to create a new project pointing to that directory — the sandbox cannot cross boundaries.

Confusing remove with deletion — remove only unregisters and does not touch disk, preventing accidental deletion of user code. If the user truly wants to delete files on disk, they must explicitly use Bash rm -rf.

Forgetting to query first — Before mutating, run ProjectQuery to confirm the projectId and current structure. projectIds are randomly generated; guessing and passing one will operate on the wrong project.

© 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/en 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/OpenLoaf107—~1.3kAutomated safety check: PassAGPL-3.0
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Project Status Artifactanthropics/claude-plugins-official37k—~5.1kAutomated safety check: PassApache-2.0
Memory Savekid0317/crewai_mas_demo162—~781Automated safety check: PassNone
Project Planneraiskillstore/marketplace4301 repos~504Automated safety check: PassMIT
Ijfw Milestone SummaryFerroxLabs/ijfw212—~1.5kAutomated safety check: PassMIT

Similar skills

  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Project Status Artifact

    anthropics/claude-plugins-official

    Official

    Builds and publishes a tabbed status page for a project with several workstreams, kept current by refreshing the same private page.

    37k GitHub stars~5.1k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Memory Save

    kid0317/crewai_mas_demo

    A skill your agent uses to persist important information from the conversation to workspace files so it survives across sessions.

    162 GitHub stars~781 tokensUpdated 4 mo ago
    Product & Project ManagementAuto-check passed
  • Project Planner

    aiskillstore/marketplace

    Detects stale project plans and suggests session commands. An agent skill from aiskillstore/marketplace.

    430 GitHub starsUsed in 1 repo~504 tokens
    Product & Project ManagementAuto-check passed
  • Ijfw Milestone Summary

    FerroxLabs/ijfw

    A skill your agent uses when the user asks for a milestone summary, milestone recap, or to summarize a milestone -- or runs /ijfw-milestone-summary.

    212 GitHub stars~1.5k tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed
  • Task Reviewer Chorus

    Chorus-AIDLC/Chorus

    Read-only adversarial Chorus task reviewer — independently verifies an implementation against its acceptance criteria and posts a single structured VERDICT comment.

    1.2k GitHub stars~5.3k tokensUpdated today
    Product & Project ManagementAuto-check passed

More from OpenLoaf/OpenLoaf

All 34 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 /…

    107 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…

    107 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.

    107 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.

    107 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.

    107 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.

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

Works with

Questions about Project Ops Skill

What does Project Ops Skill do?

Triggered when the user wants to create, open, switch, move, delete, or rename OpenLoaf's "project" entity. Project Ops Skill is an agent skill from OpenLoaf/OpenLoaf. Triggered when the user wants to create, open, switch, move, delete, or rename OpenLoaf's "project" entity.

When should I use Project Ops Skill?

Project Ops Skill fits situations like: wants to create; rename OpenLoafs project entity.

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/en 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/en 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 1.3k tokens (SKILL.md is roughly 5.1k 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: CCPM Project Management (automazeio/ccpm, 8.4k stars), Project Status Artifact (anthropics/claude-plugins-official, 37k stars), Memory Save (kid0317/crewai_mas_demo, 162 stars) and Project Planner (aiskillstore/marketplace, 430 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 107 GitHub stars. The repository holds 34 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.