Loading...
Loading...
Upgrade Obsidian wikis to latest format. Handles structure migration (phases/tasks → features/specs), comment format upgrades (adding emoji prefixes), and Johnny Decimal feature organization. Use when user mentions "upgrade wiki", "migrate wiki", "update wiki format", or has old-format comments.
npx skill4agent add cygnusfear/agent-skills obsidian-upgradeskills/obsidian-plan-wiki/SKILL.mdreferences/// Launch in parallel - each reads canonical spec then audits one area
Task(worker_type: "general-purpose", prompt: "Audit AGENTS.md against canonical spec...")
Task(worker_type: "general-purpose", prompt: "Audit comment format against canonical spec...")
Task(worker_type: "general-purpose", prompt: "Audit directory structure against canonical spec...")
Task(worker_type: "general-purpose", prompt: "Audit reference files against canonical spec...")
Task(worker_type: "general-purpose", prompt: "Audit wiki links...")Task(
worker_type: "general-purpose",
prompt: "Audit docs/AGENTS.md against canonical spec.
FIRST: Read the canonical spec completely:
- skills/obsidian-plan-wiki/SKILL.md (entire file, especially AGENTS.md Template section)
- ALL files in skills/obsidian-plan-wiki/references/
THEN: Read docs/AGENTS.md completely.
DIFF: Report every difference between existing AGENTS.md and the canonical template.
For each difference:
- Line number in existing file
- What exists (quote exactly)
- What canonical spec requires
- Whether it's missing, outdated, or wrong
The canonical spec is the authority. If it says something should exist, check for it.
"
)Task(
worker_type: "general-purpose",
prompt: "Audit all Obsidian comments in docs/ directory.
FIRST: Read skills/obsidian-plan-wiki/SKILL.md section on Task Tracking with Obsidian Comments.
Read skills/obsidian-plan-wiki/references/obsidian-open-questions-system.md if it exists.
THEN: Find EVERY file with %% comments in docs/.
DIFF: For each comment, check if it matches the canonical format.
Report each violation with:
- File path and line number
- Current comment (quote exactly)
- What canonical spec requires
- Proposed fix
"
)Task(
worker_type: "general-purpose",
prompt: "Audit wiki directory structure in docs/.
FIRST: Read skills/obsidian-plan-wiki/SKILL.md section on Directory Structure.
THEN: List actual structure of docs/ directory.
DIFF: Report differences between actual structure and canonical structure.
Note any legacy patterns that don't match the current spec.
"
)Task(
worker_type: "general-purpose",
prompt: "Audit reference files in docs/reference/.
FIRST: List all files in skills/obsidian-plan-wiki/references/
THEN: Check if corresponding files exist in docs/reference/
DIFF: For each canonical reference file:
- If missing in docs/reference/: note as missing
- If exists: diff content and report differences
"
)Task(
worker_type: "general-purpose",
prompt: "Audit all wiki links in docs/ directory.
For every [[wiki-link]] found:
1. Check if target file exists
2. Check if anchor (#section) exists in target
3. Check for unclosed links
Report each broken link with file, line, and issue.
"
)## Upgrade Plan: [Wiki Name]
### 1. AGENTS.md Fixes (CRITICAL)
| Line | Current | Canonical Requires | Action |
|------|---------|-------------------|--------|
| ... | ... | ... | ... |
### 2. Comment Upgrades
| File | Line | Current | Canonical Format |
|------|------|---------|------------------|
| ... | ... | ... | ... |
### 3. Structure Changes
| Current | Canonical |
|---------|-----------|
| ... | ... |
### 4. Reference Files
| File | Status |
|------|--------|
| ... | missing/outdated/ok |
### 5. Broken Links
| File | Line | Link | Issue |
|------|------|------|-------|
| ... | ... | ... | ... |
### Summary
- AGENTS.md: X fixes (CRITICAL)
- Comments: Y upgrades
- Structure: Z changes
- Reference files: N missing/outdated
- Links: M broken
Approve? (y/n)Task(
worker_type: "general-purpose",
prompt: "Validate wiki upgrade.
Read: skills/obsidian-plan-wiki/SKILL.md and all references/
Then verify docs/ matches the canonical spec:
- AGENTS.md matches template
- Comments match format
- Structure matches spec
- Reference files present
- No broken links
Report pass/fail for each with evidence.
"
)