diff options
| author | David Maynor <dmaynor@users.noreply.github.com> | 2026-02-23 01:09:49 -0500 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2026-02-22 22:09:49 -0800 |
| commit | 11c23bb4a6ec39ff2ae9fb432536dfd4bef21a3c (patch) | |
| tree | 68ba5c6348e2a6684a2632cb21162ff2ee27aaed | |
| parent | 0130bc30c61bca774ab5749ee315e20d0cf101da (diff) | |
fix: use >- folded scalar for SKILL.md descriptions (#20)
The literal block scalar (description: |) preserves newlines, causing
multi-line descriptions to render poorly in the Claude Code /skills
menu. This converts all 5 affected SKILL.md files to use the folded
strip scalar (>-), which collapses to a single line at parse time.
Also updates the skill-template reference to recommend >- so future
skills don't reintroduce the issue.
Affected plugins:
- skill-extractor
- ffuf-web-fuzzing
- humanizer
- planning-with-files
- wooyun-legacy
6 files changed, 28 insertions, 21 deletions
diff --git a/plugins/ffuf-web-fuzzing/skills/ffuf-web-fuzzing/SKILL.md b/plugins/ffuf-web-fuzzing/skills/ffuf-web-fuzzing/SKILL.md index 584a8be..ce19579 100644 --- a/plugins/ffuf-web-fuzzing/skills/ffuf-web-fuzzing/SKILL.md +++ b/plugins/ffuf-web-fuzzing/skills/ffuf-web-fuzzing/SKILL.md @@ -1,7 +1,11 @@ --- name: ffuf-web-fuzzing -description: | - Expert guidance for ffuf web fuzzing during authorized penetration testing. Covers directory discovery, subdomain enumeration, parameter fuzzing, authenticated fuzzing with raw requests, auto-calibration, and result analysis. Use when running ffuf scans, analyzing ffuf output, or building fuzzing strategies for web targets. +description: >- + Expert guidance for ffuf web fuzzing during authorized penetration testing. + Covers directory discovery, subdomain enumeration, parameter fuzzing, + authenticated fuzzing with raw requests, auto-calibration, and result + analysis. Use when running ffuf scans, analyzing ffuf output, or building + fuzzing strategies for web targets. allowed-tools: - Bash - Read diff --git a/plugins/humanizer/skills/humanizer/SKILL.md b/plugins/humanizer/skills/humanizer/SKILL.md index 30a2cb2..24f2c0b 100644 --- a/plugins/humanizer/skills/humanizer/SKILL.md +++ b/plugins/humanizer/skills/humanizer/SKILL.md @@ -1,7 +1,10 @@ --- name: humanizer -description: | - Identifies and removes AI writing patterns from text. Use when editing drafts, reviewing content, or rewriting text that sounds artificial. Detects inflated symbolism, promotional language, vague attributions, AI vocabulary, and structural patterns like rule-of-three overuse. +description: >- + Identifies and removes AI writing patterns from text. Use when editing drafts, + reviewing content, or rewriting text that sounds artificial. Detects inflated + symbolism, promotional language, vague attributions, AI vocabulary, and + structural patterns like rule-of-three overuse. allowed-tools: - Read - Write diff --git a/plugins/planning-with-files/skills/planning-with-files/SKILL.md b/plugins/planning-with-files/skills/planning-with-files/SKILL.md index eeee146..eccea7a 100644 --- a/plugins/planning-with-files/skills/planning-with-files/SKILL.md +++ b/plugins/planning-with-files/skills/planning-with-files/SKILL.md @@ -1,11 +1,10 @@ --- name: planning-with-files -description: | +description: >- Implements file-based planning for complex multi-step tasks. Creates - task_plan.md, findings.md, and progress.md as persistent working - memory. Use when starting tasks requiring >5 tool calls, multi-phase - projects, research, or any work where losing track of goals and - progress would be costly. + task_plan.md, findings.md, and progress.md as persistent working memory. Use + when starting tasks requiring >5 tool calls, multi-phase projects, research, + or any work where losing track of goals and progress would be costly. allowed-tools: - Read - Write diff --git a/plugins/skill-extractor/skills/skill-extractor/SKILL.md b/plugins/skill-extractor/skills/skill-extractor/SKILL.md index 6a841e8..be92027 100644 --- a/plugins/skill-extractor/skills/skill-extractor/SKILL.md +++ b/plugins/skill-extractor/skills/skill-extractor/SKILL.md @@ -1,10 +1,11 @@ --- name: skill-extractor -description: | - Extracts reusable skills from work sessions. Use when: (1) a non-obvious problem - was solved worth preserving, (2) a pattern was discovered that would help future - sessions, (3) a workaround or debugging technique needs documentation. Manual - invocation only via /skill-extractor command - no automatic triggers or hooks. +description: >- + Extracts reusable skills from work sessions. Use when: (1) a non-obvious + problem was solved worth preserving, (2) a pattern was discovered that would + help future sessions, (3) a workaround or debugging technique needs + documentation. Manual invocation only via /skill-extractor command - no + automatic triggers or hooks. allowed-tools: - Read - Write diff --git a/plugins/skill-extractor/skills/skill-extractor/references/skill-template.md b/plugins/skill-extractor/skills/skill-extractor/references/skill-template.md index 5522997..5c40678 100644 --- a/plugins/skill-extractor/skills/skill-extractor/references/skill-template.md +++ b/plugins/skill-extractor/skills/skill-extractor/references/skill-template.md @@ -5,7 +5,7 @@ Copy this template when generating a new skill. ```markdown --- name: [kebab-case-name] -description: | +description: >- [Third-person description with specific triggers. Example: "Detects infinite recursion vulnerabilities in AST visitors from cyclic data structures. Use when: (1) RecursionError during tree traversal, (2) analyzing untrusted diff --git a/plugins/wooyun-legacy/skills/wooyun-legacy/SKILL.md b/plugins/wooyun-legacy/skills/wooyun-legacy/SKILL.md index e681012..741a35a 100644 --- a/plugins/wooyun-legacy/skills/wooyun-legacy/SKILL.md +++ b/plugins/wooyun-legacy/skills/wooyun-legacy/SKILL.md @@ -1,12 +1,12 @@ --- name: wooyun-legacy -description: | +description: >- Provides web vulnerability testing methodology distilled from 88,636 - real-world cases from the WooYun vulnerability database (2010-2016). - Use when performing penetration testing, security audits, code reviews - for security flaws, or vulnerability research. Covers SQL injection, - XSS, command execution, file upload, path traversal, unauthorized - access, information disclosure, and business logic flaws. + real-world cases from the WooYun vulnerability database (2010-2016). Use when + performing penetration testing, security audits, code reviews for security + flaws, or vulnerability research. Covers SQL injection, XSS, command + execution, file upload, path traversal, unauthorized access, information + disclosure, and business logic flaws. allowed-tools: - Read - Grep |
