CtrlK
BlogDocsLog inGet started
Tessl Logo

bk-monitor-weekly-report

通过 GitHub MCP 获取用户 PR 并生成周报。当用户提到生成周报、写周报时使用。

56

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./bcs-services/bcs-project-manager/.cursor/skills/bk-monitor-weekly-report/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body lays out a sensible four-step workflow with real tool names and a repo list, but it is not self-sufficient: the referenced template and classification-rules files are missing from the bundle, the search call lacks the parameters needed to execute it, and a duplicated resources section wastes tokens. The batch search-and-aggregate process also has no validation or empty-result handling.

Suggestions

Actually ship references/classification-rules.md and references/weekly-template.md (or inline the template), since the final output step currently points at files that do not exist in the bundle.

Add the concrete search invocation: the query string for toolbase_github_search_issues including author login, type:pr, and the 7-day date window, plus how results map into the classification step.

Remove the duplicated "可用资源" section and its trailing meta-note, and add a validation checkpoint in Step 2 (e.g., what to do when a repo returns zero PRs or the API call fails).

DimensionReasoningScore

Conciseness

The workflow steps are lean with no concept over-explanation, but the entire "📦 可用资源" section is duplicated verbatim and closes with a stray meta-note ("根据 SKILL.md 中的 IF-THEN 规则判断是否需要加载") that is noise rather than instruction. Mostly efficient but includes unnecessary content that should be tightened — anchor 3; not 4 because the duplication is a real defect, not minor trimming.

3 / 5

Actionability

Concrete tool names are given ("调用 toolbase_github_get_my_user,记录 login 字段", "调用 toolbase_github_search_issues") plus a repo list and classification keywords, but key executable details are missing: no search query/parameter shape (author filter, type:pr, date range), no worked classification examples, and "按 weekly-template.md 输出" names a file without a usable path. Some concrete guidance but incomplete — anchor 3; not 4 because the search and output steps cannot be executed as written.

3 / 5

Workflow Clarity

Steps 1–4 are listed and sequenced (get user → search PRs → classify → render report), but this batch aggregation across five repositories has no validation checkpoints: no handling of empty search results, API/auth failures, or PR-count sanity checks, and no instruction on what to do when classification rules are ambiguous. The rubric's cap for batch operations without validation applies — anchor 3, and it cannot exceed 3; not 2 because the sequence itself is coherent and concrete.

3 / 5

Progressive Disclosure

The body is short with clearly signaled one-level-deep references (classification-rules.md, weekly-template.md), but neither file exists in the bundle — there is no references/ directory at all — so the mandatory output template is unexecutable, and the resource listing is duplicated. Scored against the actual (empty) bundle structure, this fails the core purpose of progressive disclosure — anchor 2; not 3 because the references are not merely unclearly signaled, they are broken.

2 / 5

Total

11

/

20

Passed

Description

78%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 concise, third-person description that clearly answers both what the skill does and when to use it, with natural trigger phrases. Its main weaknesses are thin capability coverage (only two actions named) and missing synonym variations for the trigger terms.

Suggestions

Mention the PR classification step and the TencentBlueKing repo scope (e.g., "扫描 TencentBlueKing 仓库并按需求/修复分类") to broaden the stated capabilities and sharpen distinctiveness.

Add one or two trigger synonyms such as "本周总结" or "工作汇报" so users who phrase the request differently still match the skill.

DimensionReasoningScore

Specificity

"通过 GitHub MCP 获取用户 PR 并生成周报" names the domain and two concrete actions (fetch user PRs, generate a weekly report), but coverage stops there — no mention of PR classification, the repos scanned, or the report format. Matches 'names domain and 1-2 concrete actions, but not comprehensive'; not 4 because several meaningful capabilities are omitted.

3 / 5

Completeness

The "what" is explicit ("通过 GitHub MCP 获取用户 PR 并生成周报") and the "when" is explicit with concrete trigger phrases ("当用户提到生成周报、写周报时使用"). Both are clearly and concretely answered, matching the anchor-5 shape; a score of 4 would require the when-clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

"生成周报" and "写周报" are exactly the phrases a user would naturally say for this skill. Not 5 because there is no synonym breadth (e.g., "本周总结", "weekly summary", "工作汇报"); not 3 because the two most natural trigger phrasings are present and explicit.

4 / 5

Distinctiveness Conflict Risk

The GitHub-PR-weekly-report niche with 生成周报/写周报 triggers is mostly distinct, but the description does not scope the TencentBlueKing repos, so "周报" alone overlaps any generic report- or summary-writing skill. Minor overlap risk with closely related skills — anchor 4; not 5 because the trigger terms are not unique to this skill.

4 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
TencentBlueKing/bk-bcs
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.