Hooks and other notes are in @aibuilderclub_, If you are interested, I will share how Claude Code is built in the upcoming @aibuilderclub_ weekly sessions too
```## Plan & Review
### Before starting work
- Always in plan mode to make a plan
- After get the plan, make sure you Write the plan to .claude/tasks/TASK_NAME.md.
- The plan should be a detailed implementation plan and the reasoning behind them, as well as tasks broken down.
- If the task require external knowledge or certain package, also research to get latest knowledge (Use Task tool for research)
- Don't over plan it, always think MVP.
- Once you write the plan, firstly ask me to review it. Do not continue until I approve the plan.
### While implementing
- You should update the plan as you work.
- After you complete tasks in the plan, you should update and append detailed descriptions of the changes you made, so following tasks can be easily hand over to other engineers.```
• • •
Missing some Tweet in this thread? You can try to
force a refresh
SKILL.md firstly contain a simple yaml contains metadata,
Provides just enough info about when to use this skill
+ Full markdown prompt explain detailed instructions, which will only be fed into context if agent decide to use this skill
-----
For complex skills, in the full markdown instruction,
You can refer to more md files for further instructions
+ Scripts/functions you predefined OR any other resources
So that it can call predefined functions on-demand
2/ Why Skill is more useful than MCP?
MCP was an attempt to extend agent capabilities by feeding it a bundle of tools
It was awesome and composable, however it consume loads of token and often don't work out of box (As often agent needs to use tools in certain order to make it work)
Skill is better because:
1/ Token efficiency
Many MCP contain loads of tools, and all those tools description will be fed into agent context regardless you need it or not
2/ Bundled workflow
Often you need to add additional instruction to CLAUDE.md to instruct when to use which tool
----
My gut feeling is that skill can replace MCP later:
- Skill should programmatically load MCP tools
- And MCP will be no longer needed