CtrlK
BlogDocsLog inGet started
Tessl Logo

team-tech-debt

Unified team skill for tech debt identification and remediation. Scans codebase for tech debt, assesses severity, plans and executes fixes with validation. Uses team-worker agent architecture with roles/ for domain logic. Coordinator orchestrates pipeline, workers are team-worker agents. Triggers on "team tech debt".

76

Quality

71%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.codex/skills/team-tech-debt/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

57%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description identifies a clear domain (tech debt) and lists some concrete actions, but dilutes its effectiveness by including internal architecture details (team-worker agents, coordinator, pipeline) that are irrelevant for skill selection. The trigger term is too narrow and misses common user phrasings. It would benefit from replacing implementation details with broader trigger terms and a more comprehensive 'Use when...' clause.

Suggestions

Replace architecture details ('team-worker agent architecture', 'coordinator orchestrates pipeline') with additional user-facing capabilities or use cases to improve specificity.

Expand trigger terms to include natural variations like 'technical debt', 'refactor', 'code quality', 'legacy code', 'code smells', 'cleanup'.

Add a proper 'Use when...' clause covering broader scenarios, e.g., 'Use when the user wants to identify, prioritize, or fix technical debt, refactor legacy code, or improve code quality across a codebase.'

DimensionReasoningScore

Specificity

Names the domain (tech debt) and some actions (scans codebase, assesses severity, plans and executes fixes with validation), but also includes implementation details about architecture (team-worker agents, coordinator, pipeline) that don't describe user-facing capabilities. The actual concrete actions are somewhat listed but mixed with internal architecture details.

2 / 3

Completeness

The 'what' is partially covered (scans, assesses, plans, executes fixes). There is a trigger phrase ('Triggers on "team tech debt"'), but it's extremely narrow and doesn't provide broader 'when' guidance. The trigger clause exists but is minimal and restrictive rather than helpful for selection.

2 / 3

Trigger Term Quality

Includes 'tech debt' as a key term users might say, and mentions 'codebase' and 'fixes', but the explicit trigger 'team tech debt' is narrow and somewhat unnatural. Missing common variations like 'technical debt', 'code quality', 'refactor', 'legacy code', 'code smell'.

2 / 3

Distinctiveness Conflict Risk

The combination of 'tech debt identification and remediation' with the specific trigger 'team tech debt' creates a clear niche that is unlikely to conflict with other skills. The domain is well-defined and distinct.

3 / 3

Total

9

/

12

Passed

Implementation

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured orchestration skill that clearly defines the team-worker architecture, delegation boundaries, and pipeline flow. Its greatest strengths are the precise delegation lock table, concrete spawn template, and clean progressive disclosure to role-specific files. Minor verbosity in the model selection rationale and some sections could be tightened, but overall the content is highly actionable and well-organized for a complex multi-agent workflow.

DimensionReasoningScore

Conciseness

The content is fairly dense and information-rich, but includes some sections that could be tightened — the architecture ASCII diagram, model selection rationale column, and agent coordination examples add bulk. However, most content is non-obvious configuration/protocol that Claude wouldn't inherently know, so it's not explaining basic concepts.

2 / 3

Actionability

Highly actionable: includes a concrete spawn_agent template with exact parameters, a precise delegation lock table with allowed/blocked tool calls, specific CLI commands, session directory structure, named agent targeting examples, and exact message bus API calls. Claude can execute this without guessing.

3 / 3

Workflow Clarity

The pipeline is clearly sequenced (scan → assess → plan → fix → validate) with explicit role routing logic, a delegation lock that acts as a validation checkpoint before every tool call, agent health check reconciliation steps, error handling table, and the pipeline pattern section showing how data flows between stages. The feedback loop is implicit in the GC rounds and error handling.

3 / 3

Progressive Disclosure

Excellent progressive disclosure: SKILL.md serves as a router/overview, with each role's detailed instructions in `roles/<role>/role.md` (all linked), pipeline specs in `specs/pipelines.md`, and the session directory structure clearly laid out. References are one level deep and clearly signaled in the Role Registry table.

3 / 3

Total

11

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

10

/

11

Passed

Repository
catlog22/Claude-Code-Workflow
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.