CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-permission

为 FastGPT 新资源接入权限管理。当用户需要为新资源(如 AgentSkill、Plugin 等)添加权限支持时触发。

58

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/support/permission/add-permission/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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.

An exemplary token-efficient routing document whose decision tree and file-location table demonstrate strong structure, but as shipped it is a pointer skeleton: all four referenced guides/checklists are missing from the bundle, so the actual integration steps, validation checkpoints, and reference material the body promises are unreachable. The routing quality earns high conciseness, but actionability, workflow clarity, and progressive disclosure are capped by content that exists only as broken links.

Suggestions

Ship the referenced bundle files (guides/quick-start.md, guides/full-integration.md, checklist.md, reference/README.md) or remove/inline their content — as delivered, every link in the body is broken.

Inline a minimal 5-step quick-start directly in SKILL.md so the skill remains actionable even if a guide is missing, matching the description's promise of minimal integration.

Add a validation checkpoint to the flow (e.g., a test command or verification step for the new resource's auth) so the workflow includes at least one explicit checkpoint.

DimensionReasoningScore

Conciseness

The body is a lean ~30-line router: an ASCII decision tree, a quick-links table, and a three-row code-location table, with zero explanation of concepts Claude already knows and no padding. Every line is either a routing decision, a link, or a concrete file path — matching the 'every token earns its place' anchor.

5 / 5

Actionability

The code-location table is concrete ('packages/global/support/permission/constant.ts — 添加 PerResourceTypeEnum', auth.ts paths), but the body contains no executable steps, commands, or code — all actual instruction is delegated to guide files. This matches 'some concrete guidance but incomplete; missing key details', and critically the delegated guides (./guides/quick-start.md, ./guides/full-integration.md) are not present in the bundle, so as shipped the skill stops at file pointers.

3 / 5

Workflow Clarity

The decision tree cleanly routes the user to one of two paths, which is a clear selection flow, but there is no implementation sequence in the body — no ordered steps, no validation checkpoint (e.g., how to verify the new resource's auth works before finishing), and the checklist link that might supply them points to a missing file. This sits at 'sequence present but checkpoints missing or implicit', and cannot go higher while the actual steps are unreachable.

3 / 5

Progressive Disclosure

The body structure itself is good — a well-signaled overview with one-level-deep links organized in a quick-links table. However, scoring against the actual bundle structure: none of the four referenced files (./guides/quick-start.md, ./guides/full-integration.md, ./checklist.md, ./reference/README.md) exist in the skill directory, so navigation breaks at the first hop. Good skeleton, broken targets — between the 'good structure' (4) and 'references present but not clearly signaled' (3) anchors, pulled to 3 by the broken links.

3 / 5

Total

14

/

20

Passed

Description

70%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.

A solid, third-person description that explicitly pairs a scoped 'what' with an explicit 'when to use' trigger and concrete example resources. Its main weakness is that the capability statement remains high-level — it never enumerates the concrete integration actions (resource type enum, permission constants, auth functions) that the skill body itself reveals.

Suggestions

Enumerate 2-3 concrete actions in the description, e.g., '添加 PerResourceTypeEnum、权限常量与鉴权函数' (add resource type enum, permission constants, and auth functions), to lift specificity toward the 4-5 anchors.

Add common synonyms and natural trigger variations such as '访问控制', '授权', or 'ACL' so users phrase the need differently still match.

State what distinguishes the two integration paths (simple vs. inheritance-based resources) to sharpen the 'what' and reduce residual overlap with generic permission skills.

DimensionReasoningScore

Specificity

The description names the domain ("为 FastGPT 新资源接入权限管理") and one concrete action (接入权限管理) with example resources ("如 AgentSkill、Plugin 等"), matching the 'names domain and 1-2 concrete actions' anchor. It is above a 2 because the scope is concretely bounded to FastGPT new-resource integration, but below a 4 because it never states what the integration actually involves (e.g., adding a resource type enum, writing auth functions).

3 / 5

Completeness

Both parts are explicitly present: the 'what' ("为 FastGPT 新资源接入权限管理") and the 'when' ("当用户需要为新资源…添加权限支持时触发"), with concrete example resources. It does not reach 5 because the 'what' stays high-level — it says permission management is integrated but not which concrete actions that covers.

4 / 5

Trigger Term Quality

It includes natural phrases a user would say — "添加权限支持", "权限", "FastGPT", "AgentSkill", "Plugin" — plus an explicit trigger sentence ("当用户需要为新资源…添加权限支持时触发"), giving good keyword coverage. It falls short of 5 because common synonyms like "访问控制", "授权", or "ACL" are absent.

4 / 5

Distinctiveness Conflict Risk

The FastGPT-scoped niche with distinct triggers (新资源权限接入, AgentSkill/Plugin permission support) is mostly distinct with minimal conflict risk. It is not a 5 because a request like "add permissions to a plugin" without FastGPT context could plausibly overlap with generic permission/authorization skills.

4 / 5

Total

15

/

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

relative_links

Relative link issues: 7 missing

Warning

Total

15

/

16

Passed

Repository

labring/FastGPT

Path

.agents/skills/support/permission/add-permission/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.