skillwiki 0.5.0 → 0.5.1

package/dist/cli.js

@@ -2741,7 +2741,7 @@ async function runLint(input) {
       const hasOverview = /^## Overview/m.test(body);
       if (!hasOverview) noOverview.push(page.relPath);
       const bodyFirst15 = body.split("\n").slice(0, 15).join("\n");
-      if (!/^##\s+TL;\s*DR/m.test(bodyFirst15)) missingTldrFlags.push(page.relPath);
+      if (!/^>\s*\*\*TL;DR:?\*\*/m.test(bodyFirst15) && !/^##\s+TL;\s*DR/m.test(bodyFirst15)) missingTldrFlags.push(page.relPath);
       const fmData = extractFrontmatter(text);
       const pageTags = fmData.ok && Array.isArray(fmData.data.tags) ? fmData.data.tags : [];
       if (pageTags.includes("architecture") && !body.includes("```mermaid")) {
@@ -2986,16 +2986,26 @@ ${trimmedBody}`;
           }
           const body = split.data.body;
           const rawFm = split.data.rawFrontmatter;
-          const trimmedBody = body.replace(/^\n+/, "");
+          const lines = body.split("\n");
+          let insertIndex = 0;
+          for (let i = 0; i < lines.length; i++) {
+            if (/^# /.test(lines[i])) {
+              insertIndex = i + 1;
+              while (insertIndex < lines.length && lines[insertIndex].trim() === "") {
+                insertIndex++;
+              }
+              break;
+            }
+          }
+          if (insertIndex === 0) {
+            lines.splice(0, 0, "", "> **TL;DR:** ");
+          } else {
+            lines.splice(insertIndex, 0, "> **TL;DR:** ");
+          }
+          const trimmedFm = rawFm.endsWith("\n") ? rawFm : rawFm + "\n";
           const newContent = `---
-${rawFm}
----
-
-## TL;DR
-
-- Pending summary.
-
-${trimmedBody}`;
+${trimmedFm}---
+${lines.join("\n")}`;
           await writeFile8(absPath, newContent, "utf8");
           fixed.push(relPath);
         } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "type": "module",
   "bin": {
     "skillwiki": "dist/cli.js"

package/skills/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 18 prompt-only skills (wiki-*, proj-*, using-skillwiki) backed by the deterministic `skillwiki` CLI.",
   "author": {

package/skills/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Project-aware Karpathy-style knowledge base for Codex with 18 prompt-only skills backed by the deterministic skillwiki CLI.",
   "author": {
     "name": "karlorz",

package/skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillwiki/skills",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "private": true,
   "files": [
     "wiki-*",

package/skills/wiki-crystallize/SKILL.md

@@ -16,7 +16,7 @@ Standard four reads. If cwd is inside `projects/{slug}/`, also read project READ
 1. Identify type: entity / concept / comparison / query / summary.
 2. Set `provenance:`. Default `research`. If in project context: `project` with `provenance_projects: ["[[slug]]"]`.
 3. Compose the page with citations pre-attached. Reuse existing `raw/` sources where possible. Every page MUST include:
-- `## TL;DR` as the first section after frontmatter — a 1–3 bullet summary of the page's key takeaway.
+- `> **TL;DR:**` blockquote as the first content after the title heading — a one-sentence summary of the page's key takeaway (under 200 chars). See SCHEMA.md `## TL;DR Convention`.
 - For pages tagged `architecture` or explaining workflows/systems: include a Mermaid diagram (`graph TB` or `sequenceDiagram`) in the body. Follow Obsidian-compatible Mermaid rules (see SCHEMA.md `## Mermaid Diagrams`).
 4. `skillwiki validate <page>`. If non-zero, STOP.
 5. Apply writes: page → `index.md` → `log.md`.

package/skills/wiki-ingest/SKILL.md

@@ -21,7 +21,7 @@ Run `skillwiki lang` at the start. Generate page-body prose, narrative sections,
 2. **Fetch.** Use `web_fetch` (or read local file) under Layer 2 controls (the CLI Layer 2 fetcher applies in tests; in skill runtime use `web_fetch` directly and treat any error as STOP).
 3. **Hash.** Write the raw file (frontmatter + body). Run `skillwiki hash <raw-file>` and embed the result in raw frontmatter `sha256:`.
 4. **Generate page(s).** Compose typed-knowledge page(s) with citations pre-attached (`^[raw/...]` markers). Every page MUST include:
-- `## TL;DR` as the first section after frontmatter — a 1–3 bullet summary of the page's key takeaway.
+- `> **TL;DR:**` blockquote as the first content after the title heading — a one-sentence summary of the page's key takeaway (under 200 chars). See SCHEMA.md `## TL;DR Convention`.
 - For pages tagged `architecture` or explaining workflows/systems: include a Mermaid diagram (`graph TB` or `sequenceDiagram`) in the body. Follow Obsidian-compatible Mermaid rules (see SCHEMA.md `## Mermaid Diagrams`).
 5. **Validate.** For each generated page: run `skillwiki validate <page>`. If exit ≠ 0, STOP — do not write index/log.
 6. **Apply writes in order.** raw → page(s) → `index.md` → `log.md`.