claude-code - 💡(How to fix) Fix [Bug] Cowork "Save skill" install pipeline silently truncates SKILL.md files [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#47016Fetched 2026-04-13 05:43:44
View on GitHub
Comments
1
Participants
2
Timeline
6
Reactions
0
Timeline (top)
labeled ×5commented ×1

Error Message

The "Save skill" install button in Cowork silently truncates SKILL.md files during installation. The .skill package (zip) contains the complete file, but the version written to the read-only skills FUSE mount is shorter. No error is shown to the user. The installed SKILL.md should be byte-for-byte identical to the SKILL.md inside the .skill zip package. If the install fails or produces a different file, an error should be surfaced to the user.

Error Messages/Logs

No error output -- the install completes silently with no indication of truncation.

Fix Action

Fix / Workaround

Workaround: Manually copy the correct SKILL.md to the Windows filesystem skills directory via PowerShell, then restart sessions to clear the FUSE cache.

Code Example

No error output -- the install completes silently with no indication of truncation.

Verification commands run from inside a Cowork session:

$ wc -l /sessions/*/mnt/.claude/skills/shared-trase-reference/SKILL.md
178

$ tail -1 /sessions/*/mnt/.claude/skills/shared-trase-reference/SKILL.md
...traces to a primary source (email, transcript, Notion page, Slack message, or Alex's direc

$ # Verify the .skill zip is intact:
$ unzip -o pkg-shared-trase-reference.skill -d /tmp/verify/
$ wc -l /tmp/verify/pkg-shared-trase-reference/SKILL.md
192

$ tail -1 /tmp/verify/pkg-shared-trase-reference/SKILL.md
...Format: "The previous draft '[subject]' has [specific issue] and should be deleted."
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

The "Save skill" install button in Cowork silently truncates SKILL.md files during installation. The .skill package (zip) contains the complete file, but the version written to the read-only skills FUSE mount is shorter. No error is shown to the user.

Environment:

  • Platform: Windows 11 (Microsoft Store version of Claude)
  • Skills mount: read-only FUSE (ro,nosuid,nodev,relatime)

Evidence (reproduced 3+ times):

shared-trase-reference:

  • Source file in /tmp: 192 lines, complete
  • Inside .skill zip after packaging: 192 lines, complete
  • After "Save skill" install: 178 lines, last line ends mid-word ("Alex's direc")

skill-creator-master:

  • Source file: 500 lines, ends with "Good luck!"
  • Inside .skill zip: 500 lines, complete
  • After install: 482 lines, last line contains garbled character

Key observations:

  • Truncation does NOT correlate with file size (33KB/485-line file installed fine, 16KB/192-line file truncated every time)
  • Truncation is deterministic -- repeated installs of the same package produce the same truncated result
  • The FUSE mount also caches aggressively -- manual repair via Windows filesystem doesn't immediately reflect in sessions
  • Multiple other installed skills show truncation signs, suggesting this affects many installs
  • Skills directory is read-only FUSE mount, so truncated files cannot be repaired from inside Cowork

What Should Happen?

The installed SKILL.md should be byte-for-byte identical to the SKILL.md inside the .skill zip package. If the install fails or produces a different file, an error should be surfaced to the user.

Error Messages/Logs

No error output -- the install completes silently with no indication of truncation.

Verification commands run from inside a Cowork session:

$ wc -l /sessions/*/mnt/.claude/skills/shared-trase-reference/SKILL.md
178

$ tail -1 /sessions/*/mnt/.claude/skills/shared-trase-reference/SKILL.md
...traces to a primary source (email, transcript, Notion page, Slack message, or Alex's direc

$ # Verify the .skill zip is intact:
$ unzip -o pkg-shared-trase-reference.skill -d /tmp/verify/
$ wc -l /tmp/verify/pkg-shared-trase-reference/SKILL.md
192

$ tail -1 /tmp/verify/pkg-shared-trase-reference/SKILL.md
...Format: "The previous draft '[subject]' has [specific issue] and should be deleted."

Steps to Reproduce

  1. Create a SKILL.md file with 192 lines (~16KB)
  2. Package it as a .skill zip using package_skill.py
  3. Verify the zip is intact: unzip and check wc -l shows 192 lines
  4. Click "Save skill" in the Cowork UI to install
  5. From inside a session, run: wc -l /sessions/*/mnt/.claude/skills/[skill-name]/SKILL.md
  6. Observe: line count is 178, not 192. Last line ends mid-word.
  7. Re-verify the .skill zip: still shows 192 lines. Truncation happened during install pipeline write.

Claude Model

Opus

Is this a regression?

Yes, this worked in a previous version

Last Working Version

No response

Claude Code Version

Claude Code version: 2.1.92; issue is in Cowork though

Platform

Anthropic API

Operating System

Windows

Terminal/Shell

PowerShell

Additional Information

Workaround: Manually copy the correct SKILL.md to the Windows filesystem skills directory via PowerShell, then restart sessions to clear the FUSE cache.

Skills path on Windows: C:\Users[user]\AppData\Local\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\local-agent-mode-sessions\skills-plugin[workspace-id][account-id]\skills[skill-name]\SKILL.md

This is a significant workflow disruption for power users with many custom skills -- truncated skills silently degrade every session's output quality with no indication anything is wrong.

extent analysis

TL;DR

Manually copying the correct SKILL.md to the Windows filesystem skills directory and restarting sessions may temporarily resolve the issue.

Guidance

  • Verify the integrity of the .skill zip package before installation to ensure it contains the complete SKILL.md file.
  • After installation, check the line count of the installed SKILL.md file to detect any truncation.
  • Use the provided workaround: manually copy the correct SKILL.md to the Windows filesystem skills directory via PowerShell, then restart sessions to clear the FUSE cache.
  • Consider reporting the last working version of Claude Code to help identify the regression cause.
  • Be aware that the FUSE mount's aggressive caching may require manual repair and session restarts to reflect changes.

Example

No code snippet is provided as the issue is related to a specific application (Cowork) and its interaction with the filesystem.

Notes

The root cause of the truncation is unclear, but it appears to be related to the installation pipeline write process. The workaround may not be feasible for all users, especially those with many custom skills. Further investigation is needed to identify the cause and implement a permanent fix.

Recommendation

Apply the provided workaround: manually copy the correct SKILL.md to the Windows filesystem skills directory via PowerShell, then restart sessions to clear the FUSE cache. This is a temporary solution to mitigate the issue until a permanent fix is available.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING