How to Use Skills v1.1 for Efficient Project Management

TL;DR

Skills v1.1 introduces significant updates to streamline project management, including renamed flow skills like /to-spec and /to-tickets, enhanced grilling capabilities, and a comprehensive development lifecycle. The new Wayfinder skill aids in planning large projects by breaking them into manageable parts. These updates aim to improve productivity and clarity in project execution.

Transcript

Hello friends. First video in a while and that is because I've been working on version 1.1 of my skills repo. It has an astonishing amount of stuff in there. There is an entire new approach to grilling which probably deserves its own video, but I'll try and squeeze it in here. There is a bunch of new changes to existing skills, including a rename o... Read More

Key Insights

• Skills v1.1 introduces renamed flow skills: /to-spec replaces /to-prd and /to-tickets replaces /to-issues.
• The grilling skill has been improved to prevent multiple questions at once and includes a confirmation gate.
• A complete development lifecycle is outlined, starting from grilling to implementation and code review.
• The Wayfinder skill is designed for large projects, splitting tasks into manageable parts and mapping them in GitHub issues.
• Code review now includes checks for refactoring smells, enhancing code quality.
• The research skill aids in conducting background research efficiently, saving findings in markdown format.
• The prototype skill allows for creating logic or UI prototypes to raise discussion fidelity.
• TDD skill updates separate refactoring from the red-green cycle, aligning with common TDD practices.

Questions & Answers

Q: How do I update my skills to version 1.1?

To update your skills to version 1.1, you can run the command 'npx skills add mattpocock/skills'. This will ensure you have the latest skills, including renamed ones like /to-spec and /to-tickets. If you have customized skills, consider reviewing them to integrate new updates.

Q: What is the purpose of the Wayfinder skill?

The Wayfinder skill is designed to manage large projects by breaking them into smaller, manageable tasks. It maps these tasks in GitHub issues, allowing for collaborative planning and execution. This skill helps in visualizing the project path and ensures tasks are completed in a logical sequence.

Q: Why were /to-prd and /to-issues renamed?

/to-prd was renamed to /to-spec because the term 'specification' more accurately describes the document being created, covering both technical and non-technical aspects. /to-issues was renamed to /to-tickets to avoid bias towards platforms using 'issues' and better reflect the journey from specification to implementation.

Q: How does the grilling skill improve project management?

The grilling skill has been improved by preventing multiple questions at once and adding a confirmation gate before implementation. This ensures clarity and shared understanding before moving forward, reducing errors and miscommunication during project execution.

Q: What enhancements were made to the code review process?

The code review process now includes checks for refactoring smells, utilizing concepts from Martin Fowler's refactoring book. This enhancement helps identify code issues like duplicated code or feature envy, improving overall code quality and maintainability.

Q: How does the research skill support project development?

The research skill supports project development by allowing background research to be conducted efficiently. It uses a background agent to investigate questions against primary sources, saving findings in a markdown file. This enables continuous work while research is conducted, enhancing productivity.

Q: What is the role of the prototype skill in project development?

The prototype skill allows for the creation of logic or UI prototypes, which are essential for raising the fidelity of discussions. By providing a tangible artifact, teams can better understand and react to proposed solutions, particularly in front-end development, leading to more informed decision-making.

Q: How has the TDD skill been updated in version 1.1?

In version 1.1, the TDD skill update separates refactoring from the red-green cycle, aligning with common TDD practices. This change allows for a more streamlined process where refactoring is addressed during code review, reducing the complexity of the implementation phase.

Summary & Key Takeaways

• Skills v1.1 brings significant updates to improve project management. Renamed skills like /to-spec and /to-tickets better reflect their functions. The grilling skill now prevents multiple questions and includes a confirmation step, enhancing clarity.

• The Wayfinder skill aids in planning large projects by breaking them into smaller, manageable parts, mapped in GitHub issues. This skill is particularly useful for projects that exceed a single agent session.

• Code review enhancements include refactoring smell checks, leveraging Martin Fowler's refactoring concepts. The TDD skill now separates refactoring from the red-green cycle, aligning with standard TDD practices.