1 files changed, 53 insertions, 0 deletions
diff --git a/.agents/skills/skill-improver/references/supported-updates.md b/.agents/skills/skill-improver/references/supported-updates.md
new file mode 100644
index 0000000..7d48a90
--- /dev/null
+++ b/.agents/skills/skill-improver/references/supported-updates.md
@@ -0,0 +1,53 @@
+# Supported Update Types
+
+## YAML Frontmatter Updates
+
+Update name or description:
+
+```yaml
+# Current
+---
+name: my-skill
+description: A helpful skill for various tasks.
+---
+
+# Suggested
+---
+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"
+---
+```
+
+## SKILL.md Content Updates
+
+Fix writing style (imperative form):
+
+```
+# Current
+You should create the file first.
+You need to validate the input.
+
+# Suggested
+Create the file first.
+Validate the input.
+```
+
+## References/ File Updates
+
+Add new section:
+
+```markdown
+## New Section
+
+Content to be added...
+```
+
+## New File Creation
+
+Create new example file:
+
+```markdown
+# examples/demo.md
+
+Complete example content...
+```