skill-learn

Extract FIX:, NOTE:, and TODO: tags from codebases into structured tasks.

3|1|Updated May 21, 2024
One-click install
npx skills add https://github.com/benbrastmckie/.dotfiles --skill skill-learn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-learn
Source: https://github.com/benbrastmckie/.dotfiles/tree/main/.claude/skills/skill-learn
Command: npx skills add https://github.com/benbrastmckie/.dotfiles --skill skill-learn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers spend excessive time scanning large codebases to locate FIX:/NOTE:/TODO: tags and translate them into concrete, trackable tasks. This skill streamlines that process by extracting, normalizing, and presenting findings to enable rapid task generation.

Core Features & Use Cases

  • Tag extraction across multiple file types (Lua, TeX, Markdown, Python, Shell, YAML) to surface FIX:, NOTE:, and TODO: tags.
  • Interactive task-type selection with live previews before task creation.
  • Dependency-aware task creation, state updates, and optional grouping for TODOs.

Quick Start

Run the /learn command in your project root to scan for FIX:/NOTE:/TODO: tags and start interactive task generation. Then follow prompts to select which task types to create and how to group TODO items.

Frequently Asked Questions about skill-learn

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

FAQPage Schema
How do I extract FIX, NOTE, and TODO tags from a codebase into trackable tasks?

To extract FIX, NOTE, and TODO tags from a codebase into trackable tasks, run a scan in your project root to identify and structure these tags across multiple file types. The tool surfaces findings interactively before generating any tasks.

Can I scan multiple file types like Python, Lua, and Markdown for TODO tags at the same time?

Yes, you can scan multiple file types like Python, Lua, and Markdown for TODO tags simultaneously. The scan extracts FIX, NOTE, and TODO tags across various formats including TeX, Shell, and YAML files to produce actionable tasks.

How do I group TODO items and set dependencies when generating tasks from code tags?

You can group TODO items and set dependencies through interactive prompts that guide you through task creation. The tool allows you to select specific task types, apply optional grouping for TODOs, and establish optional dependencies between structured tasks.

What is the best way to review extracted codebase tags before creating tasks?

The best way to review extracted codebase tags before creating tasks is using the interactive preview feature. It surfaces categorized findings from multi-file scans, allowing you to verify items before committing to structured task generation and state file updates.

Do I need any dependencies to run a codebase scan for FIX and NOTE tags?

No dependencies are required to run a codebase scan for FIX and NOTE tags. The skill operates independently to identify and structure tags across your project files, producing actionable tasks without needing external libraries or components.