CtrlK
BlogDocsLog inGet started
Tessl Logo

journal-entry-import

Reconstructs journal entries from external systems: bulk-imports a historical work log from a legacy source system such as a deprecated Confluence page into dated entries, enriches ticket references with self-contained detail entries reconstructed from an issue tracker, and annotates links to systems that have since moved such as a Bitbucket-to-GitLab migration. Use when asked to import an old journal, migrate a log into the journal format, turn ticket mentions into entries, expand a log with ticket detail, or point old links at a new host. This is not for repairing frontmatter on entries that already exist in this format, which is the journal CLI's own backfill command. Produces validated dated entries compatible with journal-entry-creator, complete with bidirectional cross-links and annotated external links.

72

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 well-engineered skill body: three clearly separated modes with executable steps, concrete validation commands wired to real bundled scripts, and disciplined one-level-deep progressive disclosure verified against the actual bundle. The two residual weaknesses are mild redundancy around the backfill boundary and an error-recovery loop that is implied rather than explicit.

DimensionReasoningScore

Conciseness

Largely lean — it assumes competence (never explains what Confluence, Jira, or prettier are) and puts bulk detail in bundle files. Minor trimming opportunities keep it below 5: the backfill boundary is repeated across Mindset, When Not to Use, and the description, and the Mindset phrasing "transcription and synthesis… Synthesise, don't transcribe" plus the verbatim-vs-synthesize pairing could be stated once, more cleanly. Not 3 — the padding is minor, not a pattern of unnecessary explanation.

4 / 5

Actionability

Fully executable throughout: exact commands (`npx prettier --write <files>`, `npx markdownlint-cli2 --fix`, both validator script invocations, `pantheon-journal --version`), a concrete copy-paste YAML frontmatter example, named generator scripts with the source shape they fit, and precise output paths (`YYYY/MM/YYYY-MM-DD-imported-entry.md`). Matches the 5 anchor's copy-paste-ready guidance covering the common cases.

5 / 5

Workflow Clarity

Each mode has a clear numbered sequence with explicit checkpoints — "Validate, format, lint every file", "Validate with **both** validators, then commit per year", "commit only when clean", "Commit the import as one atomic commit" — so the batch-operation validation cap is satisfied. It sits at 4 rather than 5 because the validate→fix→re-validate feedback loop is only implied by "commit only when clean", never spelled out as an explicit error-recovery step.

4 / 5

Progressive Disclosure

Scored against the actual bundle: all seven referenced files exist (4 references/*.md, 2 scripts, 2 assets) and are substantive (~750 lines total). Each mode ends with a well-signaled "Full detail: [Mode X …](references/…)" link exactly one level deep, and a closing References section annotates every bundle file's purpose. Overview and detail are cleanly split — matches the 5 anchor.

5 / 5

Total

18

/

20

Passed

Description

92%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 third-person actions for all three modes, an explicit "Use when" clause with five natural trigger phrases, and a deliberate negative boundary against the sibling skill and the CLI's backfill command. The only gap is that source-system synonyms (Confluence, Jira, old wiki) live in the what-clause rather than among the trigger terms.

DimensionReasoningScore

Specificity

Third-person concrete actions cover all three capabilities comprehensively: "bulk-imports a historical work log… into dated entries", "enriches ticket references with self-contained detail entries", "annotates links to systems that have since moved". This matches the 5 anchor (multiple specific concrete actions, comprehensive coverage); it exceeds 4 because there are no minor gaps — each mode gets a distinct, specific action.

5 / 5

Completeness

Explicitly answers both questions: the what is the three concrete reconstruction capabilities, and the when is "Use when asked to import an old journal, migrate a log into the journal format, turn ticket mentions into entries, expand a log with ticket detail, or point old links at a new host" — concrete trigger phrases, plus a negative boundary ("This is not for repairing frontmatter… the journal CLI's own backfill command"). Matches the 5 anchor exactly.

5 / 5

Trigger Term Quality

The trigger clause gives five natural phrasings ("import an old journal", "migrate a log into the journal format", "turn ticket mentions into entries", "expand a log with ticket detail", "point old links at a new host"), which is good keyword coverage. It falls short of the 5 anchor because natural source-system terms a user would say — "from Confluence", "from Jira", "old wiki" — appear only in the what-clause, not as trigger phrases.

4 / 5

Distinctiveness Conflict Risk

Clear niche (reconstructing entries from external systems) with explicit disambiguation from the closest neighbors: "not for repairing frontmatter on entries that already exist in this format, which is the journal CLI's own backfill command" and "compatible with journal-entry-creator". Minimal conflict risk — matches the 5 anchor's "clear niche with distinct triggers".

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 4 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository
pantheon-org/tekhne
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.