edisonlzy/optimize-topic-files
packages/thinking-framework-skills/skills/optimize-topic-files/SKILL.md
Apply Obsidian-flavoured formatting to a topic node's README.md, FAQ.md, and content knowledge-point files using standard templates.
$ install --global
skillsauthnpx skillsauth add edisonlzy/ai-codemons optimize-topic-filesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 9, 2026, 2:53 AM80.2s1 file scanned
SKILL.md
- name:
- optimize-topic-files
- description:
- Apply Obsidian-flavoured formatting to a topic node's README.md, FAQ.md, and content knowledge-point files using standard templates.
Optimize Topic Files
Framework Context
See Framework Structure for the canonical Obsidian knowledge tree structure definition.
Configuration
See Configuration Check Flow before executing this skill.
Subskill: Optimize Topic Files Formatting
Goal
Apply Obsidian-flavoured formatting to a topic node's README.md and FAQ.md using the obsidian-markdown skill, making the output consistent with the standard templates.
Input
- Path to
README.md(required) - Path to
FAQ.md(required) - Path to content knowledge-point
.mdfiles (optional, one or more)
Execution Steps
1. Invoke obsidian-markdown Skill
Invoke the obsidian-markdown skill for all files, with the corresponding template as the formatting target:
| File | Reference Template |
|------|-------------------|
| README.md | resources/README-template.md |
| FAQ.md | resources/FAQ-template.md |
| 知识点内容 .md | resources/CONTENT-template.md |
2. Optimize README.md
以 resources/README-template.md 为标准格式对文件进行格式化。额外注意：
aliases填写常见名称变体（中英文、缩写等）- Sub-topic Index 为空时使用
> [!todo] 待完善callout - Sub-topic Index 有内容时使用 wikilink：
[[subtopicName/README|SubtopicName]]
3. Optimize FAQ.md
以 resources/FAQ-template.md 为标准格式对文件进行格式化。额外注意：
- 旧文件若使用
## Structure，rename 为## Questions - ⚠️ 约束：确保每个 callout 标题行（如
> [!faq]- Question X：...）后有空行>，否则无法折叠
4. Optimize Content Knowledge-point Files
以 resources/CONTENT-template.md 为标准格式对每个知识点文件进行格式化。额外注意：
[!abstract]目录中的锚点链接与文件实际章节标题保持一致- 代码块确保标注语言类型
- 有多方案/多类型对比时使用表格，含 ✅/❌ 标记
Acceptance Criteria
- [ ] README.md 结构与
resources/README-template.md一致 - [ ] README.md frontmatter 包含
tags与aliases字段 - [ ] Sub-topic Index 空时使用
> [!todo] 待完善，有内容时使用 wikilink - [ ] FAQ.md 结构与
resources/FAQ-template.md一致 - [ ] FAQ.md section heading 为
## Questions - [ ] 知识点文件结构与
resources/CONTENT-template.md一致 - [ ] 知识点文件
[!abstract]目录锚点与实际章节一致
Related Skills
edisonlzy/packages/thinking-framework-skills/skills/retrieve-topic
development
VerifiedTrustedCommunity
# Retrieve Topic Node ## Goal Locate the most relevant topic directory in the knowledge tree based on the user's request. Following the progressive disclosure principle, traversal starts from the vault root and descends layer by layer, with user confirmation at each proposed match. ## Runtime Environment 本 Skill 由主 Agent 调用，dispatch 一个 **general-purpose subagent** 来执行实际的检索操作。 - 主 Agent 负责任务分发和结果聚合 - Subagent 执行目录遍历和关键词匹配 - Subagent 仅返回检索结果，不做决策 ## Input - Vault root path (resolved from con
1SKILL.mdUpdated Jun 9, 2026
edisonlzy/thinking-framework-skills-find
development
VerifiedTrustedCommunity
Locate the most relevant topic directory in the Obsidian knowledge tree based on a search query.
1SKILL.mdUpdated Jun 9, 2026
edisonlzy/divide-into-topic
development
VerifiedTrustedCommunity
Divide a large topic into smaller, well-defined sub-topic nodes through web research and user collaboration.
1SKILL.mdUpdated Jun 9, 2026
edisonlzy/deepin-topic
testing
VerifiedTrustedCommunity
Conduct deep, comprehensive research on a specified topic and produce authoritative knowledge-point Markdown files.
1SKILL.mdUpdated Jun 9, 2026