CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

process-mapper

Use when a BizOps lead, COO, or process-improvement owner needs to document an end-to-end business process (procurement, employee onboarding, incident handoff, customer-onboarding, claims adjudication) in BPMN-style notation, measure cycle times by stage, surface where work spends most of its time waiting vs. being worked, and quantify the gap between processing time and total elapsed time. Pairs Lean / Six Sigma / Theory-of-Constraints canon with deterministic stdlib-only Python tools to produce a process map, a ranked bottleneck list (with severity + root-cause hypothesis), and a cycle-time analysis (P50, P90, value-add ratio, Little's-Law throughput). Distinct from sales-pipeline, system-reliability (SLO), and strategic-OKR work — this is tactical process documentation for internal operations.

72

Quality

90%

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

86%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-engineered body: a deterministic five-step workflow with named scripts, flags, thresholds, and a copy-paste example, backed by a clean one-level-deep bundle whose referenced files all exist. The gaps are minor — no explicit error-recovery loop after input validation, and light over-explanation in the Purpose and forcing-question sections that could be trimmed for token efficiency.

Suggestions

Add one error-recovery line to the workflow, e.g. 'If process_documenter.py rejects the JSON, fix the stage entries and re-run before proceeding', to close the validation feedback loop.

Compress the forcing-question library citations (author + concept only) and drop the 'Distinct from' section, which duplicates boundary guidance already stated in the description.

DimensionReasoningScore

Conciseness

The body is dense and nearly every section earns its place — the workflow, scripts, quick example, references, and anti-patterns are all operationally relevant with no padding about concepts Claude already knows. Minor instances could be trimmed: the Purpose section narrates three failure modes, the forcing-question library carries full book/year citations ('Goldratt 1984', 'Reinertsen 2009'), and 'Distinct from' repeats boundary content already in the description. This fits 'Efficient; minor instances of over-explanation that could be trimmed' (4); it is not the 5 anchor because a few tokens (canon citations, restated distinctness) do not strictly earn their place.

4 / 5

Actionability

Fully executable guidance throughout: a five-step workflow naming exact scripts and flags ('process_documenter.py --sample', 'bottleneck_detector.py --profile saas/services/manufacturing/healthcare'), a concrete JSON intake schema with field names ('name', 'owner', 'type', 'duration_minutes_p50', 'duration_minutes_p90'), explicit verdict thresholds (VA% > 25% = HEALTHY, 10–25% = TYPICAL, < 10% = WASTE-HEAVY), explicit detection rules (P50 > 2× mean, wait % > 40%, rework % > 15%), and a copy-paste bash example. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The five-step sequence (Intake → Map → Measure → Detect → Recommend) is clearly ordered with tool invocation order restated ('invoke process_documenter.py → bottleneck_detector.py → cycle_time_analyzer.py in sequence') and sequencing discipline for the forcing questions ('Don't open question 4 before 1-3 are answered'). Validation is mentioned (process_documenter.py 'validates' the JSON) and the Assumptions section covers data quality, but there is no explicit error-recovery loop for what to do when validation fails — e.g., 'fix the JSON and re-run'. This fits 'Clear sequence with most checkpoints present; minor validation gaps' (4) rather than the 5 anchor, which requires explicit feedback loops for error recovery. The destructive/batch cap does not apply since the operations are read/analyze only.

4 / 5

Progressive Disclosure

SKILL.md is a genuine overview: three reference files, three scripts, and one asset are each referenced one level deep with a one-line description of their contents ('references/lean_six_sigma_canon.md — TIMWOOD wastes, value-stream mapping, ...'; 'bottleneck_anti_patterns.md — Seven specific anti-patterns ...'), all verified to exist, and the reference files point back to scripts rather than to further nested documents. A quick-start example is inline, and bulk detail (canon, BPMN notation, anti-patterns) is correctly split out. This matches 'Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'.

5 / 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.

A strong description with an explicit 'Use when' clause naming roles and five concrete process scenarios, a precise statement of outputs, and an explicit distinctness boundary against adjacent skill categories. The only weakness is trigger phrasing that leans on methodology jargon rather than the everyday terms users would say, leaving a few natural trigger phrases uncovered.

Suggestions

Add one or two plain-language trigger phrases users would actually say, such as 'process mapping' or 'our process is too slow', to complement the methodology terms (Theory-of-Constraints canon, Little's-Law).

Trim jargon like 'stdlib-only Python tools' from the trigger sentence; implementation details dilute the natural keywords without adding trigger value.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive coverage: 'document an end-to-end business process ... in BPMN-style notation, measure cycle times by stage, surface where work spends most of its time waiting vs. being worked' plus named outputs — 'a process map, a ranked bottleneck list (with severity + root-cause hypothesis), and a cycle-time analysis (P50, P90, value-add ratio, Little's-Law throughput)'. This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage'; nothing is left at the vague 'helps with process' level, so it is not the 4 anchor, which requires minor gaps in coverage.

5 / 5

Completeness

Both questions are answered explicitly: 'Use when a BizOps lead, COO, or process-improvement owner needs to document an end-to-end business process ...' gives concrete when-triggers, and the middle sentence states exactly what the skill produces. This matches the anchor 'Clearly and explicitly answers both what AND when with concrete trigger phrases'; it does not fall to 4, which requires the 'when' to be less explicit or specific.

5 / 5

Trigger Term Quality

Good keyword coverage with natural synonyms: 'BizOps lead, COO, process-improvement owner', 'procurement, employee onboarding, incident handoff, customer-onboarding, claims adjudication', 'cycle times', 'bottleneck'. However, a few natural user phrases are missing (e.g., 'process mapping', 'workflow', 'value stream mapping') and the 'when' clause is crowded with technical jargon ('Theory-of-Constraints canon', 'Little's-Law throughput', 'stdlib-only') a user would not naturally say. This sits between 'Good keyword coverage; a few natural terms missing' (4) and comprehensive synonym coverage (5), but the jargon density and missing everyday phrases keep it at 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche — internal business-process documentation and cycle-time analysis — and explicitly states 'Distinct from sales-pipeline, system-reliability (SLO), and strategic-OKR work — this is tactical process documentation for internal operations.' Clear niche with distinct triggers and minimal conflict risk, matching the 5 anchor rather than the 4 anchor's 'minor overlap 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

metadata_field

'metadata' should map string keys to string values

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

business-operations/skills/process-mapper/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.