From 898b52edcb47bcb3e9d6106e74ca73e74ea01e70 Mon Sep 17 00:00:00 2001
From: sillylaird <sillyfanboy@gmail.com>
Date: Thu, 3 Sep 2026 00:33:59 +0000
Subject: import live www.sillylaird.ca webroot

---
 .../examples/improvement-plan-example.md           | 85 ++++++++++++++++++++++
 1 file changed, 85 insertions(+)
 create mode 100644 .agents/skills/skill-improver/examples/improvement-plan-example.md

(limited to '.agents/skills/skill-improver/examples/improvement-plan-example.md')

diff --git a/.agents/skills/skill-improver/examples/improvement-plan-example.md b/.agents/skills/skill-improver/examples/improvement-plan-example.md
new file mode 100644
index 0000000..184ea0b
--- /dev/null
+++ b/.agents/skills/skill-improver/examples/improvement-plan-example.md
@@ -0,0 +1,85 @@
+# Skill Improvement Plan: example-skill
+
+## Priority Summary
+- **High Priority**: 2 items
+- **Medium Priority**: 1 item
+- **Low Priority**: 1 item
+
+## High Priority Improvements
+
+### 1. Fix Description Trigger Phrases
+**File**: SKILL.md:3:4
+**Dimension**: Description Quality
+**Impact**: +20 points
+
+**Current**:
+```yaml
+---
+name: example-skill
+description: A helpful skill for various tasks
+---
+```
+
+**Suggested**:
+```yaml
+---
+name: api-contract-manager
+description: This skill should be used when the user asks to "validate API contract", "check API compatibility", or "detect breaking changes"
+---
+```
+
+**Reason**: The current description lacks specific trigger phrases and uses first-person format. The suggested version follows third-person format with clear trigger phrases.
+
+### 2. Convert to Imperative Form
+**File**: SKILL.md:50:55
+**Dimension**: Writing Style
+**Impact**: +15 points
+
+**Current**:
+```markdown
+You should create the file first.
+You need to validate the input.
+```
+
+**Suggested**:
+```markdown
+Create the file first.
+Validate the input.
+```
+
+**Reason**: Skills must use imperative form without second-person language.
+
+## Medium Priority Improvements
+
+### 3. Add Progressive Disclosure
+**File**: SKILL.md
+**Dimension**: Content Organization
+**Impact**: +10 points
+
+**Current**: All content in SKILL.md (3000+ words)
+
+**Suggested**: Move detailed content to references/ directory, keep SKILL.md under 2000 words
+
+**Reason**: SKILL.md should follow progressive disclosure principles with lean main content and detailed references.
+
+## Low Priority Improvements
+
+### 4. Add Examples
+**File**: examples/demo.md (new file)
+**Dimension**: Structural Integrity
+**Impact**: +5 points
+
+**Suggested**: Create examples/demo.md with working demonstration
+
+**Reason**: Examples help users understand how to use the skill effectively.
+
+## Estimated Time to Complete
+- High Priority: 1 hour
+- Medium Priority: 2 hours
+- Low Priority: 30 minutes
+- **Total**: 3.5 hours
+
+## Expected Score Improvement
+- Current: 67/100 (D+)
+- After High Priority: 82/100 (B-)
+- After All: 87/100 (B+)
-- 
cgit v1.2.3