CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

project-ops-skill

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

73

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

90%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A dense, highly operational skill body: complete tool invocations, explicit decision rules for folderName and enableVersionControl, and a strong error-prevention section. The main gaps are the absence of a post-mutation verification step in the workflows and mild headroom in file organization.

Suggestions

Add a post-mutation verification checkpoint to the end-to-end flows (e.g. after create/move/remove, re-run ProjectQuery { mode: "get" } to confirm the resulting structure), which would raise workflow_clarity to the top anchor.

Consider moving the temp-project comparison table and the rootUri/common-errors detail into a small references/ file linked from the body, keeping SKILL.md as a tighter overview.

Quote natural trigger phrases for the remaining operations (rename, delete, open/switch) in the description to round out trigger term coverage.

DimensionReasoningScore

Conciseness

The body is lean and operational — tool tables, decision rules, and concrete invocations with almost no explanation of concepts Claude already knows. The only mildly padded phrase ("磁盘由用户主权管理") is a single instance, below the 'minor instances that could be trimmed' threshold of the level-4 anchor.

5 / 5

Actionability

Every operation has a copy-paste-ready invocation: `ProjectMutate { action: "create", title: "Q2 Marketing", folderName: "q2-marketing", ... }`, explicit rootUri conversion examples ("/Users/user/code/repo" → "file:///Users/user/code/repo"), exact update/move/remove parameter shapes, and the ToolSearch activation call — covering all common cases.

5 / 5

Workflow Clarity

Clear sequencing via the decision tree and end-to-end flows ("ProjectQuery → Glob → Grep → Read"), plus a pre-mutation checkpoint ("变更前先 ProjectQuery 确认 projectId") and an error-prevention section. Not 5 because there is no post-mutation verification step (e.g. re-querying to confirm a create/move succeeded); not 3 because the destructive-looking remove is explicitly designed non-destructive and pre-validation is present.

4 / 5

Progressive Disclosure

Well-organized single-file structure with clear sections for each action, decisions, temp projects, and common errors. No bundle files exist and none are referenced, which is acceptable for this compact size, but at ~85 lines the temp-project details and error catalog are natural candidates for a reference file, leaving minor organization headroom versus the clear-overview-with-references top anchor.

4 / 5

Total

18

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary trigger description: it names the entity and all six concrete operations, quotes natural trigger phrases, and explicitly carves out adjacent responsibilities to prevent mis-triggering. The only gap is that quoted trigger phrases cover only three of the six operations.

DimensionReasoningScore

Specificity

The description lists six concrete actions on the OpenLoaf project entity — "创建、打开、切换、移动、删除、改名" (create, open, switch, move, delete, rename) — which is comprehensive coverage of the domain's operations, matching the top anchor with multiple specific concrete actions.

5 / 5

Completeness

It explicitly answers both "what" (the six project-entity operations) and "when" ("当用户要对...时触发" plus concrete typical sayings), matching the anchor that requires both what and when with concrete trigger phrases. Not score 4 because the when-clause is fully explicit, not merely present.

5 / 5

Trigger Term Quality

Natural user phrases are quoted ("新建项目"、"把 ~/code/foo 加进来"、"列出所有项目"), giving good keyword coverage; however, common variations for the other actions (e.g. phrasings for rename, delete, or switching projects) are not quoted, so coverage is not fully comprehensive as the anchor-5 example requires.

4 / 5

Distinctiveness Conflict Risk

The explicit "**不用于**" clause disambiguates against project-internal file I/O (→ Read/Edit/Write), project-planning discussion (→ direct answer), and routine Git operations (→ Bash), giving a clear niche with minimal conflict risk.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

itsablabla/openloaf-web

Path

apps/server/src/ai/builtin-skills/project-ops/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.