Editing a skill file inside the synced-skills folder now warns Claude and the user that the change may not be saved
What
When Claude edits or writes a SKILL.md file, the Edit and Write tool results now include a syncedSkillNext field with guidance whenever that file sits in the folder that holds synced copies of the user's account skills. Edits made directly in that folder aren't actually saved and can be overwritten the next time skills sync, so the guidance tells Claude to instead use a save tool, call a propose tool, send the file to the user to save manually, or, if none of those are available, tell the user the change wasn't saved.
Why
This stops silent data loss: without it, an edit to a synced skill file could look successful but disappear on the next sync.
The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.
-F "files[]=@dcf_skill/SKILL.md;filename=dcf_skill/SKILL.md"build-with-claude/skills-guide see the edit
**Write the skill.** A skill is a folder named after the skill, holding a `SKILL.md` file. The file starts with YAML frontmatter carrying `name` and `description`, followed by the instructions as markdown. The folder name must match the `n…government/desktop/skills see the edit
A small documentation edit on Skills in Claude Desktop touched a line naming SKILL.md after this was published.