bobo-ai-cli 3.0.4 → 3.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (238) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +259 -259
  3. package/bundled-skills/CORE_SKILLS.txt +18 -18
  4. package/bundled-skills/backend-expert/SKILL.md +97 -97
  5. package/bundled-skills/code-review/SKILL.md +280 -280
  6. package/bundled-skills/code-review-expert/SKILL.md +85 -85
  7. package/bundled-skills/context-budget-analyzer/SKILL.md +76 -76
  8. package/bundled-skills/context-compressor/SKILL.md +75 -75
  9. package/bundled-skills/context-optimization-suite/SKILL.md +162 -162
  10. package/bundled-skills/frontend-expert/SKILL.md +93 -93
  11. package/bundled-skills/github/SKILL.md +12 -12
  12. package/bundled-skills/high-agency/SKILL.md +473 -473
  13. package/bundled-skills/high-agency/references/builder-patterns.md +126 -126
  14. package/bundled-skills/high-agency/references/recovery-playbook.md +298 -298
  15. package/bundled-skills/memory-manager/SKILL.md +214 -214
  16. package/bundled-skills/memory-manager/references/advanced-config.md +65 -65
  17. package/bundled-skills/orchestrator/SKILL.md +681 -681
  18. package/bundled-skills/planning-with-files/SKILL.md +193 -193
  19. package/bundled-skills/skill-creator/SKILL.md +220 -220
  20. package/bundled-skills/testing-expert/SKILL.md +99 -99
  21. package/bundled-skills/verify/SKILL.md +15 -15
  22. package/dist/agent.d.ts +5 -0
  23. package/dist/agent.js +11 -1
  24. package/dist/agent.js.map +1 -1
  25. package/dist/agents/catalog.d.ts +47 -0
  26. package/dist/agents/catalog.js +63 -5
  27. package/dist/agents/catalog.js.map +1 -1
  28. package/dist/agents/router.d.ts +12 -1
  29. package/dist/agents/router.js +43 -3
  30. package/dist/agents/router.js.map +1 -1
  31. package/dist/agents/spawn.js +36 -18
  32. package/dist/agents/spawn.js.map +1 -1
  33. package/dist/autonomous.js +5 -5
  34. package/dist/cli.js +23 -21
  35. package/dist/cli.js.map +1 -1
  36. package/dist/compactor.js +39 -39
  37. package/dist/dream.js +29 -29
  38. package/dist/image-input.d.ts +44 -0
  39. package/dist/image-input.js +161 -0
  40. package/dist/image-input.js.map +1 -0
  41. package/dist/memory.js +13 -13
  42. package/dist/project.js +15 -15
  43. package/dist/repl.js +88 -0
  44. package/dist/repl.js.map +1 -1
  45. package/dist/skills.js +54 -54
  46. package/dist/sub-agents.js +65 -65
  47. package/dist/tools/browser.js +21 -21
  48. package/dist/tools/claude-code.js +10 -10
  49. package/dist/web.js +7 -7
  50. package/dist/wiki-commands.d.ts +2 -0
  51. package/dist/wiki-commands.js +249 -0
  52. package/dist/wiki-commands.js.map +1 -0
  53. package/dist/wiki.d.ts +90 -0
  54. package/dist/wiki.js +614 -0
  55. package/dist/wiki.js.map +1 -0
  56. package/knowledge/advanced-patterns.md +70 -70
  57. package/knowledge/agent-directives.md +74 -74
  58. package/knowledge/api-integration-patterns.md +102 -0
  59. package/knowledge/code-review-protocol.md +69 -0
  60. package/knowledge/dream.md +36 -36
  61. package/knowledge/engineering.md +52 -46
  62. package/knowledge/error-catalog.md +38 -33
  63. package/knowledge/event-driven-architecture.md +43 -0
  64. package/knowledge/external-alignment.md +47 -0
  65. package/knowledge/high-agency.md +73 -0
  66. package/knowledge/image-generation.md +48 -0
  67. package/knowledge/index.json +194 -169
  68. package/knowledge/llm-wiki-pattern.md +71 -0
  69. package/knowledge/long-task-management.md +79 -0
  70. package/knowledge/memory/cache-optimization-and-skill-integration.md +102 -102
  71. package/knowledge/memory/engineering-patterns.md +134 -134
  72. package/knowledge/memory/feedback_root_structure.md +15 -15
  73. package/knowledge/memory/project-contexts.md +69 -69
  74. package/knowledge/memory/tools-and-services.md +85 -85
  75. package/knowledge/memory-management.md +72 -0
  76. package/knowledge/rules/advisor-strategy.md +204 -0
  77. package/knowledge/rules/agents.md +62 -62
  78. package/knowledge/rules/blocking-rules.md +323 -323
  79. package/knowledge/rules/cache-management.md +379 -379
  80. package/knowledge/rules/capability-evolution.md +132 -132
  81. package/knowledge/rules/coding.md +126 -126
  82. package/knowledge/rules/engineering-workflows.md +225 -225
  83. package/knowledge/rules/evomap-content-guidelines.md +354 -354
  84. package/knowledge/rules/evomap-guide.md +224 -224
  85. package/knowledge/rules/external-alignment.md +22 -0
  86. package/knowledge/rules/git.md +31 -31
  87. package/knowledge/rules/hooks.md +106 -106
  88. package/knowledge/rules/performance.md +101 -101
  89. package/knowledge/rules/remotion-auto-production.md +1120 -1120
  90. package/knowledge/rules/security.md +46 -46
  91. package/knowledge/rules/testing.md +32 -32
  92. package/knowledge/rules/work-mode.md +208 -208
  93. package/knowledge/rules.md +62 -62
  94. package/knowledge/self-evolution.md +78 -0
  95. package/knowledge/self-rationalization-guard.md +52 -0
  96. package/knowledge/skills/Skill_Seekers.md +1722 -1722
  97. package/knowledge/skills/ab-test-setup.md +557 -557
  98. package/knowledge/skills/agent-sdk-dev.md +238 -238
  99. package/knowledge/skills/agent-tools.md +136 -136
  100. package/knowledge/skills/analytics-tracking.md +597 -597
  101. package/knowledge/skills/artifacts-builder.md +89 -89
  102. package/knowledge/skills/asana.md +12 -12
  103. package/knowledge/skills/backend-expert.md +97 -97
  104. package/knowledge/skills/brand-voice.md +481 -481
  105. package/knowledge/skills/browser-use.md +419 -419
  106. package/knowledge/skills/cache-optimization-skill.md +179 -179
  107. package/knowledge/skills/canvas-design.md +147 -147
  108. package/knowledge/skills/citation-validator.md +203 -203
  109. package/knowledge/skills/clangd-lsp.md +52 -52
  110. package/knowledge/skills/code-review-expert.md +85 -85
  111. package/knowledge/skills/code-review.md +280 -280
  112. package/knowledge/skills/code-simplifier.md +12 -12
  113. package/knowledge/skills/commit-commands.md +258 -258
  114. package/knowledge/skills/competitor-alternatives.md +795 -795
  115. package/knowledge/skills/content-atomizer.md +910 -910
  116. package/knowledge/skills/content-research-writer.md +605 -605
  117. package/knowledge/skills/context-optimization-suite.md +162 -162
  118. package/knowledge/skills/context7.md +12 -12
  119. package/knowledge/skills/copy-editing.md +494 -494
  120. package/knowledge/skills/copywriting.md +510 -510
  121. package/knowledge/skills/csharp-lsp.md +40 -40
  122. package/knowledge/skills/decision-making-framework.md +154 -154
  123. package/knowledge/skills/developer-growth-analysis.md +335 -335
  124. package/knowledge/skills/direct-response-copy.md +2336 -2336
  125. package/knowledge/skills/docker-expert.md +229 -229
  126. package/knowledge/skills/document-skills.md +12 -12
  127. package/knowledge/skills/documentation-expert.md +126 -126
  128. package/knowledge/skills/email-sequence.md +1061 -1061
  129. package/knowledge/skills/email-sequences.md +910 -910
  130. package/knowledge/skills/example-plugin.md +72 -72
  131. package/knowledge/skills/explanatory-output-style.md +82 -82
  132. package/knowledge/skills/feature-dev.md +458 -458
  133. package/knowledge/skills/file-organizer.md +466 -466
  134. package/knowledge/skills/firebase.disabled.md +12 -12
  135. package/knowledge/skills/form-cro.md +488 -488
  136. package/knowledge/skills/free-tool-strategy.md +636 -636
  137. package/knowledge/skills/frontend-design-offical.md +55 -55
  138. package/knowledge/skills/frontend-design.md +41 -41
  139. package/knowledge/skills/frontend-expert.md +93 -93
  140. package/knowledge/skills/github.md +12 -12
  141. package/knowledge/skills/gitlab.md +12 -12
  142. package/knowledge/skills/gopls-lsp.md +32 -32
  143. package/knowledge/skills/got-controller.md +218 -218
  144. package/knowledge/skills/greptile.md +72 -72
  145. package/knowledge/skills/hookify.md +376 -376
  146. package/knowledge/skills/image-editor.md +189 -189
  147. package/knowledge/skills/image-enhancer.md +109 -109
  148. package/knowledge/skills/jdtls-lsp.md +49 -49
  149. package/knowledge/skills/json-canvas.md +654 -654
  150. package/knowledge/skills/keyword-research.md +559 -559
  151. package/knowledge/skills/kotlin-lsp.md +28 -28
  152. package/knowledge/skills/laravel-boost.md +12 -12
  153. package/knowledge/skills/launch-strategy.md +394 -394
  154. package/knowledge/skills/lead-magnet.md +393 -393
  155. package/knowledge/skills/learning-output-style.md +106 -106
  156. package/knowledge/skills/linear.md +12 -12
  157. package/knowledge/skills/lua-lsp.md +47 -47
  158. package/knowledge/skills/marketing-ideas.md +720 -720
  159. package/knowledge/skills/marketing-psychology.md +534 -534
  160. package/knowledge/skills/mcp-builder.md +369 -369
  161. package/knowledge/skills/meeting-insights-analyzer.md +347 -347
  162. package/knowledge/skills/memory-evolution-system.md +172 -172
  163. package/knowledge/skills/multi-lens-thinking.md +407 -407
  164. package/knowledge/skills/nano-banana-pro.md +116 -116
  165. package/knowledge/skills/newsletter.md +736 -736
  166. package/knowledge/skills/notebooklm.md +296 -296
  167. package/knowledge/skills/obsidian-bases.md +634 -634
  168. package/knowledge/skills/obsidian-markdown.md +651 -651
  169. package/knowledge/skills/onboarding-cro.md +494 -494
  170. package/knowledge/skills/orchestrator.md +681 -681
  171. package/knowledge/skills/page-cro.md +379 -379
  172. package/knowledge/skills/paid-ads.md +624 -624
  173. package/knowledge/skills/paywall-upgrade-cro.md +651 -651
  174. package/knowledge/skills/php-lsp.md +36 -36
  175. package/knowledge/skills/planning-with-files.md +193 -193
  176. package/knowledge/skills/playwright.md +12 -12
  177. package/knowledge/skills/plugin-dev.md +434 -434
  178. package/knowledge/skills/popup-cro.md +520 -520
  179. package/knowledge/skills/positioning-angles.md +330 -330
  180. package/knowledge/skills/pr-review-toolkit.md +359 -359
  181. package/knowledge/skills/pricing-strategy.md +777 -777
  182. package/knowledge/skills/programmatic-seo.md +714 -714
  183. package/knowledge/skills/pyright-lsp.md +43 -43
  184. package/knowledge/skills/quality-assurance-framework.md +168 -168
  185. package/knowledge/skills/question-refiner.md +160 -160
  186. package/knowledge/skills/ralph-loop.md +205 -205
  187. package/knowledge/skills/refactoring-expert.md +103 -103
  188. package/knowledge/skills/referral-program.md +668 -668
  189. package/knowledge/skills/research-executor.md +164 -164
  190. package/knowledge/skills/review-with-security.md +12 -12
  191. package/knowledge/skills/rust-analyzer-lsp.md +50 -50
  192. package/knowledge/skills/schema-markup.md +647 -647
  193. package/knowledge/skills/security-audit-expert.md +124 -124
  194. package/knowledge/skills/security-expert.md +140 -140
  195. package/knowledge/skills/security-guidance.md +12 -12
  196. package/knowledge/skills/seedance-prompt.md +139 -139
  197. package/knowledge/skills/self-evolution.md +1160 -1160
  198. package/knowledge/skills/seo-audit.md +432 -432
  199. package/knowledge/skills/seo-content.md +787 -787
  200. package/knowledge/skills/serena.md +12 -12
  201. package/knowledge/skills/signup-flow-cro.md +409 -409
  202. package/knowledge/skills/skill-creator.md +220 -220
  203. package/knowledge/skills/skill-manager.md +226 -226
  204. package/knowledge/skills/skill-share.md +98 -98
  205. package/knowledge/skills/slack.md +12 -12
  206. package/knowledge/skills/social-content.md +878 -878
  207. package/knowledge/skills/spec-flow-skill.md +124 -124
  208. package/knowledge/skills/stripe.md +12 -12
  209. package/knowledge/skills/supabase.md +12 -12
  210. package/knowledge/skills/swift-lsp.md +40 -40
  211. package/knowledge/skills/synthesizer.md +236 -236
  212. package/knowledge/skills/template-skill.md +16 -16
  213. package/knowledge/skills/testing-expert.md +99 -99
  214. package/knowledge/skills/theme-factory.md +72 -72
  215. package/knowledge/skills/tiktok-research.md +208 -208
  216. package/knowledge/skills/typescript-lsp.md +36 -36
  217. package/knowledge/skills/ui-ux-pro-max.md +247 -247
  218. package/knowledge/skills/verify.md +15 -15
  219. package/knowledge/skills/visual-prompt-engineer.md +102 -102
  220. package/knowledge/skills/webapp-testing.md +111 -111
  221. package/knowledge/skills/wide-research.md +191 -191
  222. package/knowledge/system.md +93 -93
  223. package/knowledge/task-router.md +46 -37
  224. package/knowledge/verification.md +38 -38
  225. package/knowledge/worker-prompt-craft.md +66 -0
  226. package/knowledge/workflows/3d-viz.md +47 -47
  227. package/knowledge/workflows/data-pipeline.md +47 -47
  228. package/knowledge/workflows/db-migration.md +51 -51
  229. package/knowledge/workflows/feature-dev.md +41 -41
  230. package/knowledge/workflows/tdd-flow.md +52 -52
  231. package/knowledge/workflows/ui-verify.md +51 -51
  232. package/package.json +74 -74
  233. package/dist/claude-bridge.d.ts +0 -18
  234. package/dist/claude-bridge.js +0 -91
  235. package/dist/claude-bridge.js.map +0 -1
  236. package/dist/tools/claude-bridge-tool.d.ts +0 -4
  237. package/dist/tools/claude-bridge-tool.js +0 -44
  238. package/dist/tools/claude-bridge-tool.js.map +0 -1
@@ -1,36 +1,36 @@
1
- ---
2
- id: "php-lsp"
3
- title: "php-lsp"
4
- category: "other"
5
- tags: ["php-lsp", "supported extensions", "installation", "more information"]
6
- triggers: []
7
- dependencies: []
8
- source: "E:/Bobo's Coding cache/.claude/skills/php-lsp"
9
- ---
10
-
11
- # php-lsp
12
-
13
- PHP language server (Intelephense) for Claude Code, providing code intelligence and diagnostics.
14
-
15
- ## Supported Extensions
16
-
17
- `.php`
18
-
19
- ## Installation
20
-
21
- Install Intelephense globally via npm:
22
-
23
- ```bash
24
- npm install -g intelephense
25
- ```
26
-
27
- Or with yarn:
28
-
29
- ```bash
30
- yarn global add intelephense
31
- ```
32
-
33
- ## More Information
34
-
35
- - [Intelephense Website](https://intelephense.com/)
36
- - [Intelephense on npm](https://www.npmjs.com/package/intelephense)
1
+ ---
2
+ id: "php-lsp"
3
+ title: "php-lsp"
4
+ category: "other"
5
+ tags: ["php-lsp", "supported extensions", "installation", "more information"]
6
+ triggers: []
7
+ dependencies: []
8
+ source: "E:/Bobo's Coding cache/.claude/skills/php-lsp"
9
+ ---
10
+
11
+ # php-lsp
12
+
13
+ PHP language server (Intelephense) for Claude Code, providing code intelligence and diagnostics.
14
+
15
+ ## Supported Extensions
16
+
17
+ `.php`
18
+
19
+ ## Installation
20
+
21
+ Install Intelephense globally via npm:
22
+
23
+ ```bash
24
+ npm install -g intelephense
25
+ ```
26
+
27
+ Or with yarn:
28
+
29
+ ```bash
30
+ yarn global add intelephense
31
+ ```
32
+
33
+ ## More Information
34
+
35
+ - [Intelephense Website](https://intelephense.com/)
36
+ - [Intelephense on npm](https://www.npmjs.com/package/intelephense)
@@ -1,193 +1,193 @@
1
- ---
2
- id: "planning-with-files"
3
- title: "Planning with Files"
4
- category: "agent-engineering"
5
- tags: ["planning with files", "star history", "why this skill?", "the problem", "installation", "clone this skill", "usage", "goal", "phases"]
6
- triggers: []
7
- dependencies: []
8
- source: "E:/Bobo's Coding cache/.claude/skills/planning-with-files"
9
- ---
10
-
11
- # Planning with Files
12
-
13
- > **Work like Manus** — the AI agent company Meta just acquired for **$2 billion**.
14
-
15
- A Claude Code skill that transforms your workflow to use persistent markdown files for planning, progress tracking, and knowledge storage — the exact pattern that made Manus worth billions.
16
-
17
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
18
- [![Claude Code Skill](https://img.shields.io/badge/Claude%20Code-Skill-blue)](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/skills)
19
-
20
- ## Star History
21
-
22
- [![Star History Chart](https://api.star-history.com/svg?repos=OthmanAdi/planning-with-files&type=Date)](https://star-history.com/#OthmanAdi/planning-with-files&Date)
23
-
24
- ---
25
-
26
- ## Why This Skill?
27
-
28
- On December 29, 2025, [Meta acquired Manus for $2 billion](https://techcrunch.com/2025/12/29/meta-just-bought-manus-an-ai-startup-everyone-has-been-talking-about/). In just 8 months, Manus went from launch to $100M+ revenue. Their secret? **Context engineering**.
29
-
30
- This skill implements Manus's core workflow pattern:
31
-
32
- > "Markdown is my 'working memory' on disk. Since I process information iteratively and my active context has limits, Markdown files serve as scratch pads for notes, checkpoints for progress, building blocks for final deliverables."
33
- > — Manus AI
34
-
35
- ## The Problem
36
-
37
- Claude Code (and most AI agents) suffer from:
38
-
39
- - **Volatile memory** — TodoWrite tool disappears on context reset
40
- - **Goal drift** — After 50+ tool calls, original goals get forgotten
41
- - **Hidden errors** — Failures aren't tracked, so the same mistakes repeat
42
- - **Context stuffing** — Everything crammed into context instead of stored
43
-
44
- ## The Solution: 3-File Pattern
45
-
46
- For every complex task, create THREE files:
47
-
48
- ```
49
- task_plan.md → Track phases and progress
50
- notes.md → Store research and findings
51
- [deliverable].md → Final output
52
- ```
53
-
54
- ### The Loop
55
-
56
- ```
57
- 1. Create task_plan.md with goal and phases
58
- 2. Research → save to notes.md → update task_plan.md
59
- 3. Read notes.md → create deliverable → update task_plan.md
60
- 4. Deliver final output
61
- ```
62
-
63
- **Key insight:** By reading `task_plan.md` before each decision, goals stay in the attention window. This is how Manus handles ~50 tool calls without losing track.
64
-
65
- ## Installation
66
-
67
- ### Option 1: Clone directly (Recommended)
68
-
69
- ```bash
70
- # Navigate to your Claude Code skills directory
71
- cd ~/.claude/skills # or your custom skills path
72
-
73
- # Clone this skill
74
- git clone https://github.com/OthmanAdi/planning-with-files.git
75
- ```
76
-
77
- ### Option 2: Manual installation
78
-
79
- 1. Download or copy the `planning-with-files` folder
80
- 2. Place it in your Claude Code skills directory:
81
- - macOS/Linux: `~/.claude/skills/`
82
- - Windows: `%USERPROFILE%\.claude\skills\`
83
-
84
- ### Verify Installation
85
-
86
- In Claude Code, the skill will automatically activate when you:
87
-
88
- - Start complex tasks
89
- - Mention "planning", "organize", or "track progress"
90
- - Ask for structured work
91
-
92
- ## Usage
93
-
94
- Once installed, Claude will automatically:
95
-
96
- 1. **Create `task_plan.md`** before starting complex tasks
97
- 2. **Update progress** with checkboxes after each phase
98
- 3. **Store findings** in `notes.md` instead of stuffing context
99
- 4. **Log errors** for future reference
100
- 5. **Re-read plan** before major decisions
101
-
102
- ### Example
103
-
104
- **You:** "Research the benefits of TypeScript and write a summary"
105
-
106
- **Claude creates:**
107
-
108
- ```markdown
109
- # Task Plan: TypeScript Benefits Research
110
-
111
- ## Goal
112
-
113
- Create a research summary on TypeScript benefits.
114
-
115
- ## Phases
116
-
117
- - [x] Phase 1: Create plan ✓
118
- - [ ] Phase 2: Research and gather sources (CURRENT)
119
- - [ ] Phase 3: Synthesize findings
120
- - [ ] Phase 4: Deliver summary
121
-
122
- ## Status
123
-
124
- **Currently in Phase 2** - Searching for sources
125
- ```
126
-
127
- Then continues through each phase, updating the file as it goes.
128
-
129
- ## The Manus Principles
130
-
131
- This skill implements these key context engineering principles:
132
-
133
- | Principle | Implementation |
134
- | ---------------------- | ----------------------------- |
135
- | Filesystem as memory | Store in files, not context |
136
- | Attention manipulation | Re-read plan before decisions |
137
- | Error persistence | Log failures in plan file |
138
- | Goal tracking | Checkboxes show progress |
139
- | Append-only context | Never modify history |
140
-
141
- ## File Structure
142
-
143
- ```
144
- planning-with-files/
145
- ├── SKILL.md # Core instructions (what Claude reads)
146
- ├── reference.md # Manus principles deep dive
147
- ├── examples.md # Real usage examples
148
- └── README.md # This file
149
- ```
150
-
151
- ## When to Use
152
-
153
- **Use this pattern for:**
154
-
155
- - Multi-step tasks (3+ steps)
156
- - Research tasks
157
- - Building/creating projects
158
- - Tasks spanning many tool calls
159
- - Anything requiring organization
160
-
161
- **Skip for:**
162
-
163
- - Simple questions
164
- - Single-file edits
165
- - Quick lookups
166
-
167
- ## Acknowledgments
168
-
169
- - **Manus AI** — For pioneering context engineering patterns that made this possible
170
- - **Anthropic** — For Claude Code and the Agent Skills framework
171
- - Based on [Context Engineering for AI Agents](https://manus.im/de/blog/Context-Engineering-for-AI-Agents-Lessons-from-Building-Manus)
172
-
173
- ## Contributing
174
-
175
- Contributions welcome! Please:
176
-
177
- 1. Fork the repository
178
- 2. Create a feature branch
179
- 3. Submit a pull request
180
-
181
- ## License
182
-
183
- MIT License — feel free to use, modify, and distribute.
184
-
185
- ## Thank You
186
-
187
- To everyone who starred, forked, and shared this skill — thank you. This project blew up in less than 24 hours, and the support from the community has been incredible.
188
-
189
- If this skill helps you work smarter, that's all I wanted.
190
-
191
- ---
192
-
193
- **Author:** [Ahmad Othman Ammar Adi](https://github.com/OthmanAdi)
1
+ ---
2
+ id: "planning-with-files"
3
+ title: "Planning with Files"
4
+ category: "agent-engineering"
5
+ tags: ["planning with files", "star history", "why this skill?", "the problem", "installation", "clone this skill", "usage", "goal", "phases"]
6
+ triggers: []
7
+ dependencies: []
8
+ source: "E:/Bobo's Coding cache/.claude/skills/planning-with-files"
9
+ ---
10
+
11
+ # Planning with Files
12
+
13
+ > **Work like Manus** — the AI agent company Meta just acquired for **$2 billion**.
14
+
15
+ A Claude Code skill that transforms your workflow to use persistent markdown files for planning, progress tracking, and knowledge storage — the exact pattern that made Manus worth billions.
16
+
17
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
18
+ [![Claude Code Skill](https://img.shields.io/badge/Claude%20Code-Skill-blue)](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/skills)
19
+
20
+ ## Star History
21
+
22
+ [![Star History Chart](https://api.star-history.com/svg?repos=OthmanAdi/planning-with-files&type=Date)](https://star-history.com/#OthmanAdi/planning-with-files&Date)
23
+
24
+ ---
25
+
26
+ ## Why This Skill?
27
+
28
+ On December 29, 2025, [Meta acquired Manus for $2 billion](https://techcrunch.com/2025/12/29/meta-just-bought-manus-an-ai-startup-everyone-has-been-talking-about/). In just 8 months, Manus went from launch to $100M+ revenue. Their secret? **Context engineering**.
29
+
30
+ This skill implements Manus's core workflow pattern:
31
+
32
+ > "Markdown is my 'working memory' on disk. Since I process information iteratively and my active context has limits, Markdown files serve as scratch pads for notes, checkpoints for progress, building blocks for final deliverables."
33
+ > — Manus AI
34
+
35
+ ## The Problem
36
+
37
+ Claude Code (and most AI agents) suffer from:
38
+
39
+ - **Volatile memory** — TodoWrite tool disappears on context reset
40
+ - **Goal drift** — After 50+ tool calls, original goals get forgotten
41
+ - **Hidden errors** — Failures aren't tracked, so the same mistakes repeat
42
+ - **Context stuffing** — Everything crammed into context instead of stored
43
+
44
+ ## The Solution: 3-File Pattern
45
+
46
+ For every complex task, create THREE files:
47
+
48
+ ```
49
+ task_plan.md → Track phases and progress
50
+ notes.md → Store research and findings
51
+ [deliverable].md → Final output
52
+ ```
53
+
54
+ ### The Loop
55
+
56
+ ```
57
+ 1. Create task_plan.md with goal and phases
58
+ 2. Research → save to notes.md → update task_plan.md
59
+ 3. Read notes.md → create deliverable → update task_plan.md
60
+ 4. Deliver final output
61
+ ```
62
+
63
+ **Key insight:** By reading `task_plan.md` before each decision, goals stay in the attention window. This is how Manus handles ~50 tool calls without losing track.
64
+
65
+ ## Installation
66
+
67
+ ### Option 1: Clone directly (Recommended)
68
+
69
+ ```bash
70
+ # Navigate to your Claude Code skills directory
71
+ cd ~/.claude/skills # or your custom skills path
72
+
73
+ # Clone this skill
74
+ git clone https://github.com/OthmanAdi/planning-with-files.git
75
+ ```
76
+
77
+ ### Option 2: Manual installation
78
+
79
+ 1. Download or copy the `planning-with-files` folder
80
+ 2. Place it in your Claude Code skills directory:
81
+ - macOS/Linux: `~/.claude/skills/`
82
+ - Windows: `%USERPROFILE%\.claude\skills\`
83
+
84
+ ### Verify Installation
85
+
86
+ In Claude Code, the skill will automatically activate when you:
87
+
88
+ - Start complex tasks
89
+ - Mention "planning", "organize", or "track progress"
90
+ - Ask for structured work
91
+
92
+ ## Usage
93
+
94
+ Once installed, Claude will automatically:
95
+
96
+ 1. **Create `task_plan.md`** before starting complex tasks
97
+ 2. **Update progress** with checkboxes after each phase
98
+ 3. **Store findings** in `notes.md` instead of stuffing context
99
+ 4. **Log errors** for future reference
100
+ 5. **Re-read plan** before major decisions
101
+
102
+ ### Example
103
+
104
+ **You:** "Research the benefits of TypeScript and write a summary"
105
+
106
+ **Claude creates:**
107
+
108
+ ```markdown
109
+ # Task Plan: TypeScript Benefits Research
110
+
111
+ ## Goal
112
+
113
+ Create a research summary on TypeScript benefits.
114
+
115
+ ## Phases
116
+
117
+ - [x] Phase 1: Create plan ✓
118
+ - [ ] Phase 2: Research and gather sources (CURRENT)
119
+ - [ ] Phase 3: Synthesize findings
120
+ - [ ] Phase 4: Deliver summary
121
+
122
+ ## Status
123
+
124
+ **Currently in Phase 2** - Searching for sources
125
+ ```
126
+
127
+ Then continues through each phase, updating the file as it goes.
128
+
129
+ ## The Manus Principles
130
+
131
+ This skill implements these key context engineering principles:
132
+
133
+ | Principle | Implementation |
134
+ | ---------------------- | ----------------------------- |
135
+ | Filesystem as memory | Store in files, not context |
136
+ | Attention manipulation | Re-read plan before decisions |
137
+ | Error persistence | Log failures in plan file |
138
+ | Goal tracking | Checkboxes show progress |
139
+ | Append-only context | Never modify history |
140
+
141
+ ## File Structure
142
+
143
+ ```
144
+ planning-with-files/
145
+ ├── SKILL.md # Core instructions (what Claude reads)
146
+ ├── reference.md # Manus principles deep dive
147
+ ├── examples.md # Real usage examples
148
+ └── README.md # This file
149
+ ```
150
+
151
+ ## When to Use
152
+
153
+ **Use this pattern for:**
154
+
155
+ - Multi-step tasks (3+ steps)
156
+ - Research tasks
157
+ - Building/creating projects
158
+ - Tasks spanning many tool calls
159
+ - Anything requiring organization
160
+
161
+ **Skip for:**
162
+
163
+ - Simple questions
164
+ - Single-file edits
165
+ - Quick lookups
166
+
167
+ ## Acknowledgments
168
+
169
+ - **Manus AI** — For pioneering context engineering patterns that made this possible
170
+ - **Anthropic** — For Claude Code and the Agent Skills framework
171
+ - Based on [Context Engineering for AI Agents](https://manus.im/de/blog/Context-Engineering-for-AI-Agents-Lessons-from-Building-Manus)
172
+
173
+ ## Contributing
174
+
175
+ Contributions welcome! Please:
176
+
177
+ 1. Fork the repository
178
+ 2. Create a feature branch
179
+ 3. Submit a pull request
180
+
181
+ ## License
182
+
183
+ MIT License — feel free to use, modify, and distribute.
184
+
185
+ ## Thank You
186
+
187
+ To everyone who starred, forked, and shared this skill — thank you. This project blew up in less than 24 hours, and the support from the community has been incredible.
188
+
189
+ If this skill helps you work smarter, that's all I wanted.
190
+
191
+ ---
192
+
193
+ **Author:** [Ahmad Othman Ammar Adi](https://github.com/OthmanAdi)
@@ -1,13 +1,13 @@
1
- ---
2
- id: "playwright"
3
- title: "playwright"
4
- category: "other"
5
- tags: ["playwright"]
6
- triggers: []
7
- dependencies: []
8
- source: "E:/Bobo's Coding cache/.claude/skills/playwright"
9
- ---
10
-
11
- # playwright
12
-
1
+ ---
2
+ id: "playwright"
3
+ title: "playwright"
4
+ category: "other"
5
+ tags: ["playwright"]
6
+ triggers: []
7
+ dependencies: []
8
+ source: "E:/Bobo's Coding cache/.claude/skills/playwright"
9
+ ---
10
+
11
+ # playwright
12
+
13
13
  Skill directory: playwright