project-router

Routes implementation tasks to the correct skills and manages the TASK_PLAN.md lifecycle.

2|1|Updated Jun 29, 2026
One-click install
npx skills add https://github.com/frederico-kluser/newsletter-crawler --skill project-router-frederico-kluser
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-router
Source: https://github.com/frederico-kluser/newsletter-crawler/tree/main/.agents/skills/project-router
Command: npx skills add https://github.com/frederico-kluser/newsletter-crawler --skill project-router-frederico-kluser

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working in a codebase with many specialized skills, it is hard to know which skill applies to a given change, fix, or analysis. This Skill removes that guesswork by classifying every task, consulting the skill catalog, and chaining the right skills before any code is touched. ## Core Features & Use Cases - Clarification-first protocol: Asks multiple scoping questions in Brazilian Portuguese and refuses to proceed while the task is underspecified. - Task planning and routing: Creates TASK_PLAN.md with acceptance criteria, classifies the task by domain and type, and selects knowledge and task skills from catalog.md. - Skill chain execution and evolution: Loads selected skills before implementing, runs each skill's evolution step on completion, and deletes TASK_PLAN.md when done. - Use Case: A user asks to add a new crawler source. The router asks clarifying questions in Portuguese, writes the plan, routes to extending-the-crawler plus related skills, executes the chain, and records learnings via meta-skill-evolution. ## Quick Start Ask the assistant to implement a fix or feature in this repository and let the project-router clarify the scope and select the right skills first.

Frequently Asked Questions about project-router

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

FAQPage Schema
How do I route a coding task to the right skill in a multi-skill repository?

Invoke the router before any work: it asks clarifying questions, creates TASK_PLAN.md, classifies the task by domain and type, then consults catalog.md to select and chain the relevant knowledge and task skills.

What is TASK_PLAN.md and when is it created?

TASK_PLAN.md is a disposable planning file written in Portuguese containing the detailed steps and acceptance criteria agreed with the user. It is created after clarification and deleted once the task completes.

Does the router work if no existing skill covers my task?

Yes. When no skill matches, it invokes meta-skill-evolution to propose a new skill as a human-reviewed draft rather than publishing one directly.

Can the router run skills with broad side effects automatically?

No. Skills with broad side effects such as deploys or structural changes require explicit user confirmation before invocation.

Why does the router ask questions in Brazilian Portuguese?

The project convention mandates that all user interactions happen in Brazilian Portuguese, so the router asks every clarifying question and writes TASK_PLAN.md in Portuguese regardless of the request language.