Skip to content

Comments

Fix workflow-skill-design plugin failing to load#102

Merged
dguido merged 2 commits intomainfrom
frabert/design-skill-fix
Feb 19, 2026
Merged

Fix workflow-skill-design plugin failing to load#102
dguido merged 2 commits intomainfrom
frabert/design-skill-fix

Conversation

@frabert
Copy link
Contributor

@frabert frabert commented Feb 19, 2026

Summary

  • The workflow-skill-design plugin failed to load because its SKILL.md and tool-assignment-guide.md documented string substitution patterns ($ARGUMENTS, !`command`) using the raw syntax, which the skill loader interprets before Claude sees the file
  • Replaced raw patterns with textual descriptions and added warnings that code fences do not prevent substitution processing
  • Bumped version to 1.0.1 so clients pick up the fix

Test plan

  • Install the plugin and verify it loads without errors
  • Invoke the designing-workflow-skills skill and confirm the substitution documentation is readable
  • Verify no raw $ARGUMENTS, $N, ${CLAUDE_SESSION_ID}, or !`command` patterns remain in plugin files
  • Run python3 .github/scripts/validate_plugin_metadata.py and confirm it passes

🤖 Generated with Claude Code

frabert and others added 2 commits February 19, 2026 18:00
The skill loader preprocesses $ARGUMENTS, $N, ${CLAUDE_SESSION_ID},
and !`command` patterns before Claude sees the file. The SKILL.md and
tool-assignment-guide.md documented these using the raw syntax, causing
shell preprocessing to attempt execution of "command" and dollar
variables to silently resolve to empty strings.

Replace raw patterns with textual descriptions and add a caution note
warning skill authors about this pitfall.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Bump version to 1.0.1 in plugin.json and marketplace.json
- Replace invented pseudo-syntax (DOLLAR-ARGUMENTS) with natural
  descriptions (a dollar sign followed by ARGUMENTS)
- Clarify shell preprocessing example with proper sentence structure
- Warn that code fences do not prevent substitution processing

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@dguido dguido merged commit 2f0ae6f into main Feb 19, 2026
6 checks passed
@dguido dguido deleted the frabert/design-skill-fix branch February 19, 2026 17:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants