CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

production-scheduling

Codified expertise for production scheduling, job sequencing, line balancing, changeover optimization, and bottleneck resolution in discrete and batch manufacturing. Informed by production schedulers with 15+ years experience. Includes TOC/drum-buffer-rope, SMED, OEE analysis, disruption response frameworks, and ERP/MES interaction patterns. Use when scheduling production, resolving bottlenecks, optimizing changeovers, responding to disruptions, or balancing manufacturing lines.

Quality

79%

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 ./skills/production-scheduling/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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, expert-level knowledge base with strong decision frameworks, concrete thresholds, and validation checkpoints — but it is a monolithic ~220-line file that re-explains fundamentals Claude already knows (OEE formula, scheduling basics) and duplicates bottleneck/disruption content across sections. Splitting reference material into bundle files and trimming textbook passages would materially improve token efficiency.

Suggestions

Move the Key Edge Cases, Communication Patterns templates, Escalation Protocols tables, and Performance Indicators into reference files (e.g., references/edge-cases.md, references/escalation.md) and link them from a lean SKILL.md overview, converting the monolithic body into a navigable one-level-deep structure.

Cut or compress explanations of concepts Claude already knows — the term-by-term OEE calculation, forward vs. backward scheduling definitions, and 'work order carries the routing, the BOM...' passages — keeping only the plant-specific thresholds and heuristics that add real information.

Deduplicate bottleneck identification (Core Knowledge, Decision Frameworks, and Key Edge Cases all cover it) and disruption response (Core Knowledge 'Disruption Response' vs. 'Disruption Re-Sequencing') into a single authoritative section each.

DimensionReasoningScore

Conciseness

The domain-specific parameters (buffer zones at 33%/67%, ">85%" drum threshold, escalation timelines) earn their tokens, but the ~220-line body also explains textbook concepts Claude already knows — the OEE formula broken down term-by-term, forward vs. backward scheduling definitions, and what a work order carries — and repeats bottleneck identification and disruption-response logic across three separate sections (Core Knowledge, Decision Frameworks, Key Edge Cases). This fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than anchor 4, where only minor trimming would be needed.

3 / 5

Actionability

The Decision Frameworks are genuinely executable: a four-step job-priority decision tree with named dispatching rules (EDD, SPT, setup-aware EDD), a five-step changeover optimization procedure, concrete thresholds, quantified examples ("$5,000/hour... $200K+/year"), and copy-adaptable message templates. Core Knowledge sections, however, are partly descriptive concept summaries rather than directives, leaving minor gaps versus anchor 5's fully executable guidance.

4 / 5

Workflow Clarity

"How It Works" gives a clear six-step sequence, and the Decision Frameworks include explicit validation checkpoints — "Validate against due dates: Run the optimized sequence through the schedule. If any job misses its due date, insert it earlier" — plus a shift-level plan-vs-actual feedback loop ("Every shift, compare scheduled vs. actual... re-sequence the remaining horizon"). The top-level "How It Works" steps themselves lack checkpoints, which keeps this at anchor 4 rather than 5; the disruption framework's freeze/lock steps prevent it from dropping to 3.

4 / 5

Progressive Disclosure

No bundle files exist — everything (eight edge cases, communication templates, escalation tables, KPI tables, ERP/MES patterns) is inlined in a single ~220-line SKILL.md with no reference files to offload to. Section headers give it real structure, but substantial content that clearly belongs in separate reference files (edge cases, templates, escalation protocols) is inline with no navigation layer beyond the header list, matching anchor 3 ('content that should be separate is inline') rather than anchor 4's mostly-appropriate placement.

3 / 5

Total

14

/

20

Passed

Description

87%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, multi-trigger "Use when" clause and comprehensive, specific capability framing anchored to a well-defined manufacturing domain. Its only weaknesses are two credibility-fluff sentences ("Codified expertise", "15+ years experience") and a few missing natural synonyms.

DimensionReasoningScore

Specificity

Names multiple concrete capabilities ("job sequencing, line balancing, changeover optimization, and bottleneck resolution") plus specific frameworks ("TOC/drum-buffer-rope, SMED, OEE analysis... ERP/MES interaction patterns"), approaching the comprehensive coverage of anchor 5. However, filler phrases like "Codified expertise" and "Informed by production schedulers with 15+ years experience" add no capability information, keeping it at anchor 4 rather than 5.

4 / 5

Completeness

Explicitly answers both questions: what it does ("production scheduling, job sequencing, line balancing, changeover optimization, and bottleneck resolution in discrete and batch manufacturing") and when to use it via a concrete "Use when..." clause with five trigger scenarios. This matches the anchor-5 example structure exactly, and is clearly above anchor 4 where the 'when' is less specific.

5 / 5

Trigger Term Quality

The when-clause uses five natural phrases users would actually say: "scheduling production, resolving bottlenecks, optimizing changeovers, responding to disruptions, or balancing manufacturing lines". A few common variations are missing (e.g., "production planning", "shop floor", "dispatching"), so it fits anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche — discrete/batch manufacturing scheduling — with distinctive triggers ("changeovers", "line balancing", "bottlenecks") that no generic calendar-scheduling or general-manufacturing skill would share. Conflict risk is minimal, matching anchor 5; anchor 4's 'minor overlap risk with closely related skills' is not a better fit.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

affaan-m/ECC

Path

skills/production-scheduling/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.