Skip to content

Dianel555/DSkills / skills/agent-wiki

agent-wiki

Unverified

Incremental LLM-friendly wiki generator for Obsidian note vaults. Use when: (1) Building wiki from notes, (2) Ingesting notes to wiki, (3) Obsidian LLM wiki, (4) Incremental knowledge base management. Triggers: 'build wiki from notes', 'ingest notes to wiki', 'Obsidian LLM wiki', 'incremental knowledge base'.

FileKindSize
.env.exampleother408 B
README.mdmarkdown15.3 KB
SKILL.mdskill md23.3 KB
pyproject.tomlmanifest2.1 KB
references/cli-matrix.mdmarkdown5.9 KB
references/homepage.mdmarkdown6.1 KB
references/index-schema.mdmarkdown6.9 KB
references/site-export.mdmarkdown3.1 KB
references/topic-authoring.mdmarkdown5.1 KB
scripts/agent_wiki/__init__.pyscript103 B
scripts/agent_wiki/authors.pyscript3.9 KB
scripts/agent_wiki/bases.pyscript4.0 KB
scripts/agent_wiki/batch.pyscript3.7 KB
scripts/agent_wiki/boundary.pyscript55.8 KB
scripts/agent_wiki/cache.pyscript5.5 KB
scripts/agent_wiki/canvas.pyscript8.0 KB
scripts/agent_wiki/cleanup.pyscript2.4 KB
scripts/agent_wiki/cli.pyscript97 B
scripts/agent_wiki/commands.pyscript28.3 KB
scripts/agent_wiki/config.pyscript4.2 KB
scripts/agent_wiki/coverage.pyscript2.1 KB
scripts/agent_wiki/frontmatter.pyscript1.6 KB
scripts/agent_wiki/home.pyscript7.9 KB
scripts/agent_wiki/keywords.pyscript2.0 KB
scripts/agent_wiki/links.pyscript14.7 KB
scripts/agent_wiki/plugins.pyscript2.1 KB
scripts/agent_wiki/quality.pyscript7.6 KB
scripts/agent_wiki/scanner.pyscript6.7 KB
scripts/agent_wiki/site.pyscript39.2 KB
scripts/agent_wiki/source_type.pyscript3.2 KB
scripts/agent_wiki/wiki_index.pyscript17.4 KB
scripts/agent_wiki/worklist.pyscript5.7 KB
scripts/agent_wiki_cli.pyscript5.5 KB
templates/home/academic.mdmarkdown2.9 KB
templates/home/dashboard.mdmarkdown2.7 KB
templates/home/magazine.mdmarkdown2.5 KB
templates/query/research.mdmarkdown787 B
tests/conftest.pyscript177 B
tests/fixtures/sample_vault/attachments/image.pngbinary26 B
tests/fixtures/sample_vault/课程/双缝实验.mdmarkdown47 B
tests/fixtures/sample_vault/课程/量子力学.mdmarkdown75 B
tests/test_alias_resolution.pyscript7.5 KB
tests/test_authors.pyscript2.2 KB
tests/test_backlinks.pyscript7.0 KB
tests/test_bases.pyscript4.7 KB
tests/test_batch.pyscript3.0 KB
tests/test_benchmark_index.pyscript2.1 KB
tests/test_boundary_platform.pyscript695 B
tests/test_cache.pyscript2.1 KB
tests/test_cache_strict.pyscript2.1 KB
tests/test_canvas.pyscript8.3 KB
tests/test_capture.pyscript5.5 KB
tests/test_cleanup.pyscript1.2 KB
tests/test_cleanup_init_strict.pyscript2.1 KB
tests/test_cli.pyscript6.2 KB
tests/test_config.pyscript2.0 KB
tests/test_coverage.pyscript7.2 KB
tests/test_e2e.pyscript2.5 KB
tests/test_evaluate_enhancements.pyscript14.7 KB
tests/test_featured_base.pyscript4.3 KB
tests/test_final_security_review.pyscript6.6 KB
tests/test_frontmatter.pyscript1.1 KB
tests/test_gen_home.pyscript4.9 KB
tests/test_gen_site_cli.pyscript3.9 KB
tests/test_home.pyscript7.7 KB
tests/test_immutability.pyscript1.4 KB
tests/test_immutability_capture.pyscript2.4 KB
tests/test_index_capture.pyscript4.5 KB
tests/test_index_cli.pyscript5.4 KB
tests/test_index_extension.pyscript17.0 KB
tests/test_index_source_count.pyscript3.0 KB
tests/test_package_structure.pyscript3.4 KB
tests/test_plugins.pyscript3.1 KB
tests/test_quality.pyscript21.3 KB
tests/test_quality_cli.pyscript5.5 KB
tests/test_quality_prose_weight.pyscript3.8 KB
tests/test_quality_script_fairness.pyscript4.7 KB
tests/test_quality_tier_refactor.pyscript4.0 KB
tests/test_scanner.pyscript2.6 KB
tests/test_scanner_fast_path.pyscript3.5 KB
tests/test_scanner_strict.pyscript2.1 KB
tests/test_secure_temporary_writes.pyscript978 B
tests/test_site.pyscript20.2 KB
tests/test_site_import_isolation.pyscript3.9 KB
tests/test_site_slug_refactor.pyscript3.6 KB
tests/test_source_type.pyscript3.5 KB
tests/test_status_metrics.pyscript4.1 KB
tests/test_status_quality.pyscript5.3 KB
tests/test_status_worklist.pyscript3.0 KB
tests/test_structure.pyscript501 B
tests/test_topic_category.pyscript4.2 KB
tests/test_topic_path_boundary.pyscript2.2 KB
tests/test_vault_boundary.pyscript24.3 KB
tests/test_wiki_index.pyscript13.3 KB
tests/test_worklist.pyscript12.3 KB
tests/test_worklist_cli.pyscript1.9 KB

references/topic-authoring.md

View on GitHub
# Topic Authoring Reference

Loaded on demand from SKILL.md. Covers the topic `type` taxonomy, per-type section
templates, and authoring conventions.

## Type Field (Page Kind)

The optional frontmatter `type` field describes the page kind and is **orthogonal** to the auto-derived `source_type` (file format):
- `type` = **page kind** (concept/method/paper/person/event/place/overview) — Agent-authored, optional
- `source_type` = **file format** (markdown/pdf/web/mixed) — **CLI-derived** from `sources[]`, never hand-edited

**Recommended `type` vocabulary** (stored as-is if outside this list, never rejected):
- `concept` — principles, definitions, theoretical constructs
- `method` — techniques, algorithms, protocols
- `paper` — research papers, publications
- `person` — researchers, authors, historical figures
- `event` — conferences, experiments, historical events
- `place` — institutions, labs, geographical locations
- `overview` — surveys, meta-analyses, literature reviews
- `material` — materials as the object of study (gels, cellulose, polymers, composites, alloys, …) — their synthesis, structure, and properties, across many applications
- `device` — devices/systems as the object of study (sensors, actuators, e-skin, batteries, robots, …)
- `application` — an application domain or use case (healthcare, robotics, energy, construction, …)
- `review` — a survey/roadmap of one technology or field (narrower than `overview`, which sweeps a literature landscape)

> `type` is the page **genre**; the orthogonal subject clustering (材料 / 器件 / 方法 …) belongs in `topic_category`. See `index-schema.md`.

## Lead Sentence Rule (定位句)

**Every topic body MUST open with a single positioning sentence** (定位句) before the first `##` heading:
- Concisely states what/who/where the topic is
- No heading, no list, no quote block — plain paragraph
- Example: `量子叠加原理是量子力学的核心原理,描述量子态可以同时处于多个本征态的线性组合。`

The CLI computes a read-only `has_lead` metric (quality metrics) but **never authors prose**.

## Per-Type Section Templates

Each `type` has a recommended priority-ordered section structure. Omit sections the source doesn't support.

**concept**:
1. `## 定义` (definition)
2. `## 核心原理` (core principles)
3. `## 应用场景` (applications)
4. `## 相关概念` (related concepts)
5. `## 历史发展` (historical development, if relevant)

**method**:
1. `## 原理` (principle/mechanism)
2. `## 步骤` (procedure/algorithm)
3. `## 参数` (parameters/configuration, if applicable)
4. `## 适用范围` (scope/constraints)
5. `## 案例` (examples/applications)

**paper**:
1. `## 研究问题` (research question)
2. `## 方法` (methods)
3. `## 主要发现` (key findings)
4. `## 技术路线` (technical routes, if applicable)
5. `## 局限性` (limitations, if stated)

**person**:
1. `## 基本信息` (affiliation, period)
2. `## 主要贡献` (key contributions)
3. `## 代表作` (notable works)
4. `## 合作者` (collaborators, if relevant)

**event**:
1. `## 背景` (context)
2. `## 经过` (proceedings/timeline)
3. `## 成果` (outcomes/impact)
4. `## 参与者` (participants, if relevant)

**place**:
1. `## 概况` (overview)
2. `## 研究方向` (research areas)
3. `## 主要成果` (notable achievements)
4. `## 关键人物` (key people, if relevant)

**overview**:
1. `## 范围` (scope/coverage)
2. `## 主要主题` (major themes)
3. `## 关键文献` (key references)
4. `## 研究趋势` (research trends)

## Conflict/Contradiction Convention

When source notes **disagree on a fact** (different values, contradictory claims):
- **Do NOT silently pick one** — record the disagreement
- Create a dedicated `## ⚠️ 矛盾` (conflict) section listing each variant with its source
- Example:
  ```markdown
  ## ⚠️ 矛盾

  - 来源 A.md 称实验于 1926 年完成
  - 来源 B.md 称实验于 1927 年完成
  ```

## Quality Metrics Detail

Metrics computed from the markdown body (all read-only):
- `sections`: count of level-2 to level-6 ATX headings (`##` to `######`), excluding level-1 title
- `evidence_lines`: count of blockquote lines (starting with `> `)
- `prose_weight`: script-aware prose measure combining CJK ideographs and Latin words
  - CJK characters (East Asian Width W/F, Unicode category L/N): weighted ×10
  - Latin/other word runs: weighted ×16
  - Ratio calibrated so equivalent-information content in CJK and Latin tier equally
- `cjk_chars`, `latin_words`: component counts (transparency)
- `prose_chars`: raw NFC character count (retained for transparency)
- `has_image`: boolean, true if body contains Obsidian (`![[image.ext]]`) or Markdown (`![](url)`) image embeds
- `has_lead`: boolean, true if first non-blank line after optional level-1 heading is a paragraph (not heading/list/quote/table/image-only)

Tiers are **monotonic** in all dimensions (adding prose, sections, evidence, images, or
sources never lowers tier). The formula is **deterministic** and **script-fair**: CJK and
Latin content of equivalent information density receive the same tier.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall