project-ops-skill

Manage OpenLoaf projects with query and mutate operations.

94|9|Updated Dec 8, 2025
One-click install
npx skills add https://github.com/OpenLoaf/OpenLoaf --skill project-ops-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-ops-skill
Source: https://github.com/OpenLoaf/OpenLoaf/tree/main/apps/server/src/ai/builtin-skills/project-ops
Command: npx skills add https://github.com/OpenLoaf/OpenLoaf --skill project-ops-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenLoaf projects are central to workflow; this skill streamlines creating, opening, switching, moving, deleting, and renaming projects, reducing manual coordination across the multi-project workspace.

Core Features & Use Cases

  • ProjectQuery: query the project tree or a single project (mode: list/get) to understand structure and context.
  • ProjectMutate: create, update, move, or remove projects to shape the project hierarchy.
  • Read / Glob / Grep: read and search within a project to locate files and information.
  • Edit / Write: edit or create files inside a project when needed.
  • Bash: run commands at the project root to initialize or maintain environments.

Use cases include creating a new project, listing all projects, moving a project between parent groups, or removing a project registry.

Quick Start

Create a new project using ProjectMutate with action create, title New Project, and folderName new-project, then verify with ProjectQuery.

Frequently Asked Questions about project-ops-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create and manage projects within a nested hierarchy?

To manage projects within a nested hierarchy, you use mutate operations to create, move, or remove project folders, and query operations to list the resulting tree structure. This enforces a safe project hierarchy across top-level and nested contexts.

What is the best way to list all my current projects?

The best way to list current projects is by running a project query in list mode. This queries the project tree to display the full workspace structure, helping you understand the context and relationships of all registered projects.

Can I move an existing project to a different parent folder?

Yes, you can move an existing project to a different parent folder using mutate operations. This allows you to restructure your project hierarchy safely by relocating projects between parent groups as your workflow evolves.

Does project management require explicit activation for updates?

Yes, project management enforces safe usage by requiring explicit activation of ProjectQuery or ProjectMutate operations. This strict requirement prevents accidental modifications when handling root URIs, folder names, and version control decisions.

Why do I need to specify a folder name when creating a project?

You need to specify a folder name during project creation to establish the physical directory for the project root. This folder name, combined with the project title and root URI, ensures proper version control and environment initialization.