taskfile-manager

Validate Taskfile.yml against Rule 090 best practices and report violations.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/brianclaridge/_claude --skill taskfile-manager
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: taskfile-manager
Source: https://github.com/brianclaridge/_claude/tree/main/skills/taskfile-manager
Command: npx skills add https://github.com/brianclaridge/_claude --skill taskfile-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates Taskfile.yml against official best practices and common pitfalls to prevent CI failures and misconfigurations.

Core Features & Use Cases

  • Parse and validate Taskfile syntax and naming conventions
  • Produce a structured report of errors, warnings, and informational notes
  • Suggest fixes and best-practices for future Taskfile entries

Quick Start

Run the Taskfile validation script against your Taskfile.yml: uv run --directory ${CLAUDE_SKILLS_PATH}/taskfile-manager python -m scripts ./Taskfile.yml

Frequently Asked Questions about taskfile-manager

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

FAQPage Schema
How do I validate a Taskfile.yml against best practices?

Taskfile.yml validation identifies violations of naming conventions, template syntax, task structure, and cross-platform constraints by parsing your file and applying Rule 090 criteria. Run the validator against your local Taskfile.yml to generate a line-numbered report with concrete YAML fixes and best-practice recommendations.

What Taskfile.yml best practices does this validator check?

The validator checks variable naming, template syntax, task naming, namespace formatting, descriptions, aliases, silent mode directives, platform-specific settings, and cross-platform constraints. It catches common pitfalls that cause CI failures and configuration mismatches.

Can I use this validator in my CI pipeline?

Yes. The validator produces structured error, warning, and informational reports suitable for CI integration. It prevents Taskfile.yml misconfigurations from reaching deployment by catching violations early and suggesting fixes before commits.

What does the validation report include?

The report delivers line-numbered violations, severity classifications, and concrete YAML fixes for each issue found. This structured output enables both manual review and automated remediation workflows.

Do I need a specific Taskfile.yml structure to use this validator?

No prerequisites beyond a valid Taskfile.yml file in your local project. The validator applies Rule 090 criteria to any Taskfile.yml and works regardless of task count, namespace depth, or platform directives already in use.

Why does my Taskfile.yml work locally but fail in CI?

Common causes include platform directive mismatches, inconsistent variable naming, missing task descriptions, or silent mode configuration issues. Running this validator catches these violations before they propagate to CI, preventing environment-specific failures.