CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pi-history-ingest

Ingest Pi coding-agent session history into Obsidian as distilled knowledge. Use for importing or mining ~/.pi/agent/sessions or Pi conversation logs; use wiki-agent for targeted topic-only recall.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

77%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-sequenced ingest procedure with explicit validation gates and failure handling — the workflow and command guidance are exemplary. The two weaknesses are redundancy (provenance and privacy rules each stated twice over) and a broken disclosure layer: the cited `references/pi-data-format.md` is missing from the bundle while its supposed content is inlined.

Suggestions

Merge the duplicated provenance guidance (the 'Add provenance markers' bullets, the 'Mark provenance' block, and verification-gate item 4) into one section, and fold the 'Privacy and Compliance' section into Step 2's 'Critical privacy filter' — this removes roughly 20 lines of repetition.

Create `references/pi-data-format.md` (or remove the citation): the body points to it for field-level parsing notes, but no `references/` directory exists in the bundle, leaving a dangling reference.

Move the entry-type table and message-role field breakdown into `references/pi-data-format.md`, keeping only the ranked data-source list inline in SKILL.md, so the overview stays lean and the detail lives one level deep.

DimensionReasoningScore

Conciseness

Mostly efficient — dense tables, concrete commands, no padding with concepts Claude already knows — but full sections are duplicated: provenance rules appear three times ("Add provenance markers using the convention in `llm-wiki`", the separate "**Mark provenance** per the convention in `llm-wiki`" block, and source-verification-gate item 4), and privacy rules are repeated between Step 2's "Critical privacy filter" and the standalone "Privacy and Compliance" section. Not 4: these are whole redundant sections, not minor trims; not 2: signal density stays high throughout with no tutorial-style explanation.

3 / 5

Actionability

Copy-paste-ready commands with concrete arguments: `find "$PI_HISTORY_PATH" -name "*.jsonl" -type f`, `obsidian-wiki memory sync PI_HISTORY_INGEST sessions=<sessions> ... --takeaways "..."`, `${QMD_CLI:-qmd} update`; plus an exact manifest JSON block, specific field names (`parentId`, `session_info.name`), and a precise parsing algorithm (build id map, find leaf, walk parentId chain, reverse). Not 4: the specific commands and record formats cover the common cases end-to-end for this instruction-style skill.

5 / 5

Workflow Clarity

Steps 1–5 are clearly sequenced with validation checkpoints and feedback loops for this batch operation: a delta summary before deep parsing, a manifest-driven new/modified/unchanged gate, an explicit five-item source verification gate with a recovery path ("If a claim cannot be verified, either delete it or mark it `^[inferred]` / `^[ambiguous]`"), and QMD failure handling ("If QMD refresh fails, do not roll back the vault changes; report the QMD status separately"). Not 4: both validation and error-recovery branches are explicit at multiple stages, satisfying the feedback-loop requirement for batch operations.

5 / 5

Progressive Disclosure

References are clearly signaled ("See `references/pi-data-format.md` for field-level parsing notes", pointers to `llm-wiki/SKILL.md` and `.skills/llm-wiki/references/MEMORY.md`), but the bundle contains no `references/` directory at all — `references/pi-data-format.md` does not exist, so the promised field-level detail is unreachable. Meanwhile ~50 lines of field-level detail (the entry-type table and message-role breakdown) that would belong in that file are inlined in SKILL.md. Not 4: the one file-level reference is dangling; not 2: section structure is good and references are prominently signaled rather than buried.

3 / 5

Total

16

/

20

Passed

Description

82%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete what, an explicit 'Use for...' trigger clause with natural terms, and active disambiguation against the sibling wiki-agent skill. The only soft spot is that the capability list stays at the ingestion level rather than enumerating the distinct pipeline actions.

DimensionReasoningScore

Specificity

"Ingest Pi coding-agent session history into Obsidian as distilled knowledge" names the domain and a couple of concrete actions (ingest, "importing or mining"), but the verbs are variations of one ingestion action rather than several distinct capabilities (parse, cluster, distill, update manifest), so coverage is not comprehensive. Not 2: the domain is concrete and actions are named, not minimal or generic.

3 / 5

Completeness

Explicitly answers both: what — "Ingest Pi coding-agent session history into Obsidian as distilled knowledge" — and when — "Use for importing or mining ~/.pi/agent/sessions or Pi conversation logs", with concrete trigger phrases matching the anchor-5 pattern. Not 4: the 'when' clause is explicit and trigger-anchored, not merely implied or generic.

5 / 5

Trigger Term Quality

Natural user phrases are present: "importing or mining ~/.pi/agent/sessions", "Pi conversation logs", "session history". Not 5: common variations and the file extension users might mention (.jsonl, "session logs", "chat history") are absent.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Pi coding-agent sessions, the specific ~/.pi/agent/sessions path) with minimal conflict risk, and the clause "use wiki-agent for targeted topic-only recall" actively routes the nearest overlapping use case to a different skill. Not 4: it doesn't just reduce overlap, it explicitly disambiguates the sibling skill.

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

Ar9av/obsidian-wiki

Path

.skills/pi-history-ingest/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.