CtrlK
BlogDocsLog inGet started
Tessl Logo

gather-business-context

Gather business context from connected or provided sources so downstream analysis starts with the right framing. Use when an analytical question depends on missing context, such as what a metric means, what changed recently, or which sources should be checked. If the same prompt asks for diagnosis, recommendation, or a deliverable, gather context first and continue to the focused skill.

60

Quality

69%

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 ./packages/opencode/src/skill/builtin/.bundle/data-analytics/workflows/gather-business-context/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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 well-structured, well-sequenced instruction-only skill with a clear boundary, explicit stop/continue conditions, and genuinely useful source-reconciliation guidance. Its weaknesses are redundancy across the Boundary, workflow, and Standards sections and guidance that often stays at strategy level rather than concrete, checkable instructions.

Suggestions

Merge the 'Boundary' section and the opening paragraph of '# Gather Business Context' into a single statement of scope, and fold the 'Standards' section's overlap with steps 3 and 6 into those steps to remove the duplicated guidance (lowest-scoring dimension: conciseness).

Make each workflow step's output concrete — e.g., give a compact template for the context note in step 8 (summary / definitions with links / recent changes / conflicts / gaps) so 'lightweight context note' becomes a checkable artifact (actionability).

Convert step 2's narrowing advice into an explicit retry loop ('if a source comes back thin, revise anchors and re-run once before marking it unavailable') so the feedback guidance is a structured checkpoint rather than a side remark (workflow_clarity).

DimensionReasoningScore

Conciseness

Mostly efficient prose with no padding about concepts Claude already knows, but there is real redundancy that could be tightened: the 'Boundary' section repeats the boundary restated in the opening paragraph, steps 4, 5, and 8 all restate the same filtering guidance in different words ('Extract Only Decision-Shaping Context', 'Keep Source Notes Compact', 'Keep it readable, but do not compress away details'), and the 'Standards' section largely restates steps 3 and 6. This matches the level 3 anchor of mostly efficient with some tightening possible, not level 4's 'minor instances'.

3 / 5

Actionability

There is some concrete guidance — what to capture ('a metric definition, current rollout state, dashboard link, owner note, source conflict'), how to narrow searches ('a metric plus a dashboard name, a feature plus a launch window'), and tie-break rules ('Prefer the newest explicit decision artifact over older plans') — but much of the workflow stays at strategy level ('Establish the analytical topic', 'Search every enabled or provided source family') without specific executable steps. For an instruction-only skill this is partially actionable but incomplete, matching level 3 rather than level 4's mostly-executable guidance.

3 / 5

Workflow Clarity

Eight clearly numbered, well-sequenced steps with an explicit stopping condition and pre-stop checklist in step 7 ('Stop gathering context when the downstream task can be framed well enough to proceed... Before stopping, make sure the next step has a clear enough understanding...') and a continue-condition with gap labeling in the same step. This is a clear sequence with a real checkpoint, but there are no explicit feedback loops (e.g., re-check an anchor that came back thin is mentioned in step 2 but not as a structured retry), so it sits at level 4 rather than level 5.

4 / 5

Progressive Disclosure

The file has good structure — a Boundary section, a Workflow with eight titled subsections, and a Standards section — and it references no bundle files (none exist), so all guidance is appropriately self-contained at one level. It is around 67 lines, above the under-50-line simple-skill threshold, and the Standards section overlaps with workflow content that could be consolidated, which leaves minor organization gaps consistent with level 4 rather than the clean, well-split organization of level 5.

4 / 5

Total

14

/

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 strong description that clearly and explicitly states both what the skill does and when to use it, with natural trigger phrasing and explicit routing away from sibling analysis skills. Its main weakness is that the capability statement is a single abstract action — 'gather business context' — without more concrete sub-actions, and the trigger condition is somewhat broad.

DimensionReasoningScore

Specificity

The description names the domain ('Gather business context from connected or provided sources') and one core action with its purpose ('so downstream analysis starts with the right framing'), but does not enumerate several concrete actions. The phrases that follow ('what a metric means, what changed recently, or which sources should be checked') describe triggering situations rather than additional capabilities, so coverage is not comprehensive as required for level 4-5.

3 / 5

Completeness

It explicitly answers both questions: what ('Gather business context from connected or provided sources so downstream analysis starts with the right framing') and when ('Use when an analytical question depends on missing context, such as what a metric means, what changed recently, or which sources should be checked'). Both are concrete and paired with explicit trigger phrases, matching the level 5 anchor.

5 / 5

Trigger Term Quality

Natural user phrasing is present — 'an analytical question depends on missing context, such as what a metric means, what changed recently, or which sources should be checked' — plus routing terms like 'diagnosis, recommendation, or a deliverable'. A few common synonyms users might say (e.g., 'background', 'context gathering', 'brief me on') are missing, which keeps it below the comprehensive level 5.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche (pre-analysis context gathering) and actively disambiguates from sibling skills ('If the same prompt asks for diagnosis, recommendation, or a deliverable, gather context first and continue to the focused skill'). However, 'depends on missing context' is broad enough that many analytical or research prompts could match, leaving minor overlap risk with general research skills rather than the minimal risk of level 5.

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
XiaomiMiMo/MiMo-Code
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.