summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Maynor <dmaynor@users.noreply.github.com>2026-02-23 01:09:49 -0500
committerGitHub <noreply@github.com>2026-02-22 22:09:49 -0800
commit11c23bb4a6ec39ff2ae9fb432536dfd4bef21a3c (patch)
tree68ba5c6348e2a6684a2632cb21162ff2ee27aaed
parent0130bc30c61bca774ab5749ee315e20d0cf101da (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
-rw-r--r--plugins/ffuf-web-fuzzing/skills/ffuf-web-fuzzing/SKILL.md8
-rw-r--r--plugins/humanizer/skills/humanizer/SKILL.md7
-rw-r--r--plugins/planning-with-files/skills/planning-with-files/SKILL.md9
-rw-r--r--plugins/skill-extractor/skills/skill-extractor/SKILL.md11
-rw-r--r--plugins/skill-extractor/skills/skill-extractor/references/skill-template.md2
-rw-r--r--plugins/wooyun-legacy/skills/wooyun-legacy/SKILL.md12
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