caozheshan-gm/homemadeskills

Overview

This skill keeps an Obsidian markdown encyclopedia note synchronized with a list of installed skills. It generates consistent, minimal entries for each skill (heading plus 适用/文档/用法) and helps find missing or duplicate entries. It can optionally include a load line when a code-export format is provided.

How this skill works

The tool reads a skills source (plain text list or an exported code list) and compares it to headings in the target Obsidian note. It prints which skills are missing and emits compact markdown stubs you can paste into the note. Re-running the check verifies there are no remaining gaps and flags duplicates or formatting issues.

When to use it

• After installing or removing skills to keep the encyclopedia up to date
• When skill file locations or documentation links change
• Before publishing or sharing the vault to ensure consistency
• When you want uniform entries for each skill without creating extra notes

Best practices

• Only edit the encyclopedia note unless the owner asks for broader changes
• Preserve the existing note style; add the minimal, confident text needed
• Prefer using the skill’s own short description metadata for the 适用 field
• Avoid inventing usage details—leave TODO if you can’t verify them
• Watch for special path naming (system-level skills may need a prefix)

Example use cases

• Generate stubs for newly installed skills so you can paste them into the encyclopedia
• Detect and remove duplicated skill headings before a vault export
• Add a consistent 文档 link for each skill after reorganizing docs
• Include optional load lines when you export from a code registry
• Run a final pass to ensure frontmatter dates and code fences are consistent