Back to list
shinpr

task-analyzer

by shinpr

Production-ready TypeScript boilerplate for Claude Code with specialized AI agents

162🍴 15📅 Jan 23, 2026

SKILL.md


name: task-analyzer description: Analyzes task essence and selects appropriate skills. Returns scale estimates and metadata. Use when starting tasks or selecting skills.

Task Analyzer

Provides metacognitive task analysis and skill selection guidance.

Skills Index

See skills-index.yaml for available skills metadata.

Task Analysis Process

1. Understand Task Essence

Identify the fundamental purpose beyond surface-level work:

Surface WorkFundamental Purpose
"Fix this bug"Problem solving, root cause analysis
"Implement this feature"Feature addition, value delivery
"Refactor this code"Quality improvement, maintainability
"Update this file"Change management, consistency

Key Questions:

  • What problem are we really solving?
  • What is the expected outcome?
  • What could go wrong if we approach this superficially?

2. Estimate Task Scale

ScaleFile CountIndicators
Small1-2Single function/component change
Medium3-5Multiple related components
Large6+Cross-cutting concerns, architecture impact

Scale affects skill priority:

  • Larger scale → process/documentation skills more important
  • Smaller scale → implementation skills more focused

3. Identify Task Type

TypeCharacteristicsKey Skills
ImplementationNew code, featurescoding-standards, typescript-testing
FixBug resolutioncoding-standards, typescript-testing
RefactoringStructure improvementcoding-standards, implementation-approach
DesignArchitecture decisionsdocumentation-criteria, implementation-approach
QualityTesting, reviewtypescript-testing, integration-e2e-testing

4. Tag-Based Skill Matching

Extract relevant tags from task description and match against skills-index.yaml:

Task: "Implement user authentication with tests"
Extracted tags: [implementation, testing, security]
Matched skills:
  - coding-standards (implementation, security)
  - typescript-testing (testing)
  - typescript-rules (implementation)

5. Implicit Relationships

Consider hidden dependencies:

Task InvolvesAlso Include
Error handlingdebugging, testing
New featuresdesign, implementation, documentation
Performanceprofiling, optimization, testing
Frontendtypescript-rules, typescript-testing
API/Integrationintegration-e2e-testing

Output Format

Return structured analysis with skill metadata from skills-index.yaml:

taskAnalysis:
  essence: <string>  # Fundamental purpose identified
  type: <implementation|fix|refactoring|design|quality>
  scale: <small|medium|large>
  estimatedFiles: <number>
  tags: [<string>, ...]  # Extracted from task description

selectedSkills:
  - skill: <skill-name>  # From skills-index.yaml
    priority: <high|medium|low>
    reason: <string>  # Why this skill was selected
    # Pass through metadata from skills-index.yaml
    tags: [...]
    typical-use: <string>
    size: <small|medium|large>
    sections: [...]  # All sections from yaml, unfiltered

Note: Section selection (choosing which sections are relevant) is done separately after reading the actual SKILL.md files.

Skill Selection Priority

  1. Essential - Directly related to task type
  2. Quality - Testing and quality assurance
  3. Process - Workflow and documentation
  4. Supplementary - Reference and best practices

Metacognitive Question Design

Generate 3-5 questions according to task nature:

Task TypeQuestion Focus
ImplementationDesign validity, edge cases, performance
FixRoot cause (5 Whys), impact scope, regression testing
RefactoringCurrent problems, target state, phased plan
DesignRequirement clarity, future extensibility, trade-offs

Warning Patterns

Detect and flag these patterns:

PatternWarningMitigation
Large change at onceHigh riskSplit into phases
Implementation without testsQuality riskFollow TDD
Immediate fix on errorRoot cause missedPause, analyze
Coding without planScope creepPlan first

Score

Total Score

75/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

+5
最近の活動

1ヶ月以内に更新

+10
フォーク

10回以上フォークされている

+5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

+5

Reviews

💬

Reviews coming soon