npx skills add ...
npx skills add microsoft/semantic-link-labs --skill planning-with-files
**USE THIS FOR COMPLEX TASKS.** Implements Manus-style file-based planning for multi-step tasks. Creates task_plan.md, findings.md, and progress.md in .agent_cache/<task-name>/. Use when: implementing multiple APIs, refactoring modules, research tasks, or ANY task requiring >5 tool calls.
npx skills add microsoft/semantic-link-labs --skill planning-with-files
Work like Manus: Use persistent markdown files as your "working memory on disk." This skill helps you plan, track, and checkpoint complex tasks that span multiple files, APIs, or sessions.
ALWAYS use this skill when:
Skip this skill for:
All planning files go in .agent_cache/<task-name>/:
<task-name>.agent_cache/add-admin-apis/.agent_cache/migrate-lakehouse-module/.agent_cache/add-direct-lake-functions/| File | Purpose | When to Update |
|---|---|---|
task_plan.md | Phases, progress, current status | After each phase completes |
findings.md | Research, discoveries, decisions | After ANY discovery |
progress.md | Session log, test results, errors | Throughout session |
Never start a complex task without task_plan.md. Non-negotiable.
"After every 2 view/search/explore operations, IMMEDIATELY save key findings to files."
This prevents information from being lost as context grows.
Before major decisions, read the plan file. This pushes goals into your attention window.
After completing any phase:
in_progress -> completeEvery error goes in the plan file. This builds knowledge and prevents repetition.
Track what you tried. Mutate the approach.
Include in findings.md:
After finishing all work:
When resuming work, verify you can answer:
| Question | Answer Source |
|---|---|
| Where am I? | Current phase in task_plan.md |
| Where am I going? | Remaining phases |
| What's the goal? | Goal statement in plan |
| What have I learned? | findings.md |
| What have I done? | progress.md |
If you can't answer these, read all 3 planning files before continuing.
| Situation | Action | Reason |
|---|---|---|
| Just wrote a file | DON'T read | Content still in context |
| After 2+ searches | Write findings NOW | Before info is lost |
| Starting new phase | Read plan/findings | Re-orient context |
| Error occurred | Read relevant file | Need current state |
| Resuming after gap | Read ALL planning files | Recover state |
| Before major decision | Read task_plan.md | Refresh goals |
| Don't | Do Instead |
|---|---|
| Start executing immediately | Create plan file FIRST |
| State goals once and forget | Re-read plan before decisions |
| Hide errors and retry silently | Log errors to plan file |
| Stuff everything in context | Store large content in files |
| Repeat failed actions | Track attempts, mutate approach |
| Skip testing | Always include test tasks |
| Skill | When to Use |
|---|---|
| add-function | Adding new API wrapper functions |
| rest-api-patterns | REST API implementation patterns |
| write-tests | Writing unit tests |
| code-style | Running linters and formatters |
| run-tests | Running pytest locally |
| github-repo-explore | Finding reference implementations |