mirror of
https://github.com/OthmanAdi/planning-with-files.git
synced 2026-04-26 16:36:00 +03:00
[GH-ISSUE #39] No /planning-with-files command in Claude Code #27
Labels
No labels
bug
pull-request
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
starred/planning-with-files#27
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @dalisoft on GitHub (Jan 19, 2026).
Original GitHub issue: https://github.com/OthmanAdi/planning-with-files/issues/39
Hey @OthmanAdi
Thank you for such amazing plugin.
Hovewer, it does not work or i am using incorrect.
I followed guide from here for Claude Code installation but no
/planning-with-filesshown.OS details:
Video demo:
https://github.com/user-attachments/assets/7081f39e-62b8-474f-9ece-d2598dfddbbb
Similar issues:
@dalisoft commented on GitHub (Jan 19, 2026):
I followed the instructions from here but got weird results
@dalisoft commented on GitHub (Jan 19, 2026):
Plugin exists in
~/.claude@wqh17101 commented on GitHub (Jan 19, 2026):
I met the same problem. （windows）
@dalisoft commented on GitHub (Jan 19, 2026):
@wqh17101 Hope to get resolved
@wqh17101 commented on GitHub (Jan 19, 2026):
To implement the
/planning-with-filescommand, this plugin needs acommandsfolder. @OthmanAdi@wqh17101 commented on GitHub (Jan 19, 2026):
/planning-with-fileswhen ready to work on a complex task/clearto start fresh/planning-with-filesagain — it will automatically recover where you left offWithout
/planning-with-fileswe can not do the right thing in the README.md@OthmanAdi
@zoffyzhang commented on GitHub (Jan 20, 2026):
same problem
@OthmanAdi commented on GitHub (Jan 20, 2026):
✅ Fixed in v2.4.0
Hey everyone! I've identified and fixed the root cause.
The Problem
The SKILL.md was using non-standard frontmatter fields that aren't supported by the official Agent Skills specification:
hooks:- NOT supported in SKILL.md (was causing parse errors)version:at top level - NOT supported (should be inmetadata.version)user-invocable:- NOT in official specallowed-tools:as YAML list - Should be space-delimited stringThe Fix
Released v2.4.0 with spec-compliant SKILL.md:
How to Update
Then restart Claude Code and try
/planning-with-filesagain.Release: https://github.com/OthmanAdi/planning-with-files/releases/tag/v2.4.0
@dalisoft @wqh17101 @zoffyzhang - Please try this and let me know if it works!
@dalisoft commented on GitHub (Jan 20, 2026):
@OthmanAdi Thank you for fix (maybe partially).
Now command itself working and can be triggered but it does not appear.
https://github.com/user-attachments/assets/7e8ce162-4b40-4426-8216-750faca9c5bc
@OthmanAdi commented on GitHub (Jan 20, 2026):
Update: Found the REAL problem
The issue wasn't the SKILL.md frontmatter - it was duplicate folder structure.
The repo had BOTH:
./skills/planning-with-files/✅ correct./planning-with-files/❌ causing conflictsThis confused Claude Code's skill discovery.
Fixed in commit
3e08dd9- removed the duplicate folder.Try installing v2.4.1 (will release in 1 min):
The SKILL.md is back to how it was (with hooks, user-invocable, etc.).
@dalisoft commented on GitHub (Jan 20, 2026):
@OthmanAdi Thank you for second attempt of fix.
Same problem as above.
claudeAnd neither of them are fixed the issue. Can you look again please?
Like in isolated environment like
dockeror new user?@OthmanAdi commented on GitHub (Jan 20, 2026):
v2.5.0 - THE REAL FIX (I hope!)
@dalisoft Sorry for the confusion. I finally compared with official Anthropic skills and found they use ONLY 3 frontmatter fields:
Our SKILL.md had 4 EXTRA unsupported fields that were breaking slash command discovery:
version:user-invocable:allowed-tools:hooks:All removed in v2.5.0. SKILL.md now matches the exact format of official Anthropic skills.
Clean Install
Then try typing
/planning-with-filesLet me know if this works!
@OthmanAdi commented on GitHub (Jan 20, 2026):
✅ CONFIRMED WORKING - v2.5.0
Just tested on Windows - now appears and works!
The fix: SKILL.md must have ONLY 3 frontmatter fields (matching official Anthropic format):
Clean install steps:
Restart Claude Code completely, then type
/planning-with-files@dalisoft @wqh17101 @zoffyzhang - please try v2.5.0 and confirm it works for you!
@OthmanAdi commented on GitHub (Jan 20, 2026):
UPDATE: Partial Fix
The command WORKS but has a quirk:
✅ Works: Type the full command
/planning-with-filesand press enter - it works!❌ Doesn't appear: It won't show up in autocomplete when you type
/planWorkaround: Just type the full
/planning-with-filescommand manually. You can save it as a snippet or alias in your terminal.@dalisoft @wqh17101 @zoffyzhang - Can you confirm this behavior on your end? Type the FULL
/planning-with-filescommand and see if it executes.@OthmanAdi commented on GitHub (Jan 20, 2026):
✅ FULLY FIXED - Autocomplete Now Works!
@dalisoft @wqh17101 @zoffyzhang
The issue: Plugins install to cache, but Claude Code's autocomplete scans
~/.claude/skills/folder.The solution: Copy the skill to
~/.claude/skills/after installing:Working Installation Steps
Now type
/planand it will appear in autocomplete!Confirmed working on Windows. Please test and let me know!
@dalisoft commented on GitHub (Jan 20, 2026):
Sorry for delayed response @OthmanAdi
It worked at https://github.com/OthmanAdi/planning-with-files/issues/39#issuecomment-3771928421
But seems not broken
not sure about this
https://github.com/user-attachments/assets/a43d394b-3f2c-4361-b30f-aa3078936fe6
I tried similar command
cp -r ~/.claude/plugins/cache/planning-with-files/planning-with-files/*/skills/planning-with-files .claude/skills/but not works@OthmanAdi commented on GitHub (Jan 20, 2026):
@dalisoft You're missing the
~(tilde) in your path.Your command (wrong):
Correct command:
.claude/skills/= current directory (wrong)~/.claude/skills/= home directory (correct)The
~is required to copy to your home directory where Claude Code looks for skills.@aprils148 commented on GitHub (Jan 20, 2026):
It works for me
@dalisoft commented on GitHub (Jan 20, 2026):
I want use only for workspace / project-level. Not globally
@OthmanAdi commented on GitHub (Jan 20, 2026):
The plugin is already workspace-scoped. The copy step is ONLY for autocomplete.
Two options:
Option 1: Skip autocomplete (project-level only)
Just install the plugin
claude plugins install OthmanAdi/planning-with-files
Skip the copy step
Type the full /planning-with-files command manually (no autocomplete)
Option 2: Per-project skill (if supported)
Create .claude/skills/ in your project root and copy there:
mkdir -p .claude/skills
cp -r ~/.claude/plugins/cache/planning-with-files/planning-with-files/*/skills/planning-with-files .claude/skills/
Then add .claude/skills/ to your .gitignore if you don't want to commit it.
The plugin functionality works regardless - the copy step only enables autocomplete suggestions.
please let me know if it works @dalisoft
@dalisoft commented on GitHub (Jan 20, 2026):
@OthmanAdi I tried your Solution 2 but does not work.
I am already tried in https://github.com/OthmanAdi/planning-with-files/issues/39#issuecomment-3772457682 (see above)
The problem is Auto-complete not working and auto-complete is easy and quicker
@yyuziyu commented on GitHub (Jan 22, 2026):
You can refer to obra/superpowers
/2.5.0 is based on plugin version changes.
Create folder
Create command
Restart Claude Code
@OthmanAdi commented on GitHub (Jan 26, 2026):
✅ Fixed in v2.11.0
Hey everyone! This is now properly fixed with a new shorter command.
The Solution
Added \ which creates \ command.
How to use:
No extra copy steps needed. No \ setup. Just install and type .
Command Options
Release
https://github.com/OthmanAdi/planning-with-files/releases/tag/v2.11.0
中文说明
在 v2.11.0 版本中修复了这个问题！
使用方法：
无需额外的复制步骤，无需设置 \。只需安装后输入 \ 即可。
@dalisoft @wqh17101 @zoffyzhang @yyuziyu - Thank you all for your patience and feedback! 感谢大家的耐心和反馈！
@OthmanAdi commented on GitHub (Feb 5, 2026):
@dalisoft any updates?
@dalisoft commented on GitHub (Feb 21, 2026):
Sorry for late reply @OthmanAdi
Due of personal problems currently cannot test nor use any coding tools for now and next weeks
@OthmanAdi commented on GitHub (Feb 21, 2026):
@dalisoft Damn! ok! i hope you are in a safe area and have no political and war problems man! take care.