OthmanAdi/planning-with-files v2.4.0

v2.4.0 - Fix SKILL.md Spec Compliance

on GitHub

Critical Fix: SKILL.md Now Complies with Agent Skills Specification

This release fixes Issue #39 where /planning-with-files slash command was not appearing for users.

What Was Wrong

The previous SKILL.md used non-standard frontmatter fields that are NOT supported by the official Agent Skills specification:

# OLD (broken)
version: "2.3.0"           # ❌ NOT supported at top level
user-invocable: true       # ❌ NOT in official spec
hooks:                     # ❌ NOT supported in SKILL.md
  PreToolUse: ...

The Fix

SKILL.md now uses spec-compliant format:

# NEW (fixed)
name: planning-with-files
description: ...
license: MIT
metadata:
  version: "2.4.0"
  author: OthmanAdi
allowed-tools: Read Write Edit Bash Glob Grep WebFetch WebSearch

What Changed

• ✅ Removed invalid hooks: field from SKILL.md frontmatter
• ✅ Moved version to metadata.version
• ✅ Removed user-invocable: field
• ✅ Changed allowed-tools: to space-delimited string
• ✅ Removed ${CLAUDE_PLUGIN_ROOT} variable references

How to Update

# Remove old installation
rm -rf ~/.claude/skills/planning-with-files

# Re-install fresh
claude plugins install OthmanAdi/planning-with-files

Thanks

• @wqh17101 for identifying the root cause
• @dalisoft and @zoffyzhang for reporting the problem

Full Changelog: https://github.com/OthmanAdi/planning-with-files/blob/master/CHANGELOG.md