twl:workflow-tech-debt-triage

Inventory and triage tech-debt issues across labels into actionable remediation tasks.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/shuu5/twill --skill twl-workflow-tech-debt-triage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: twl:workflow-tech-debt-triage
Source: https://github.com/shuu5/twill/tree/main/plugins/twl/skills/workflow-tech-debt-triage
Command: npx skills add https://github.com/shuu5/twill --skill twl-workflow-tech-debt-triage

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inventory and triage open tech-debt issues across labels to surface actionable remediation tasks and enable consistent reporting.

Core Features & Use Cases

  • Unified issue inventory across tech-debt/warning and tech-debt/deferred-high labels with deduplication by issue number.
  • Solve-detection against delta specs by extracting keywords from titles and matching them to deltaspec/specs/*/spec.md.
  • Facilitates integration with a triage-execute pipeline by grouping related issues by module and preparing actionable triage steps.
  • Provides guardrails: handle zero results, large result sets, and non-existent modules gracefully with clear messaging.

Quick Start

Trigger the workflow using the command /twl:workflow-tech-debt-triage.

Frequently Asked Questions about twl:workflow-tech-debt-triage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I triage tech debt issues across multiple GitHub labels automatically?

You can triage tech debt issues by inventorying open issues across tech-debt/warning and tech-debt/deferred-high labels with automatic deduplication by issue number to surface actionable remediation tasks. The workflow groups related issues by module for centralized processing.

How does solved-detection against delta specs work for issue management?

Solved-detection against delta specs works by extracting keywords from issue titles and matching them to deltaspec/specs/*/spec.md files to identify which tech debt issues have already been resolved. This automated matching prevents redundant work during triage.

Can I use this tech debt triage workflow for large result sets or empty repositories?

Yes, the tech debt triage workflow handles zero results, large result sets, and non-existent modules gracefully with clear messaging. These guardrails ensure the automation pipeline does not fail silently during issue retrieval or module validation.

What's the best way to group related tech debt issues by module for remediation?

The best way to group related tech debt issues is by using a triage-execute pipeline that validates modules and prepares actionable triage steps. This approach groups integration candidates by module to streamline delegation with clear safety checks.

Do I need any dependencies to run the automated tech debt triage pipeline?

No external dependencies are required to run the automated tech debt triage pipeline. The workflow operates independently to retrieve issues, perform solved-detection against delta specs, and execute module validation without additional packages.