Skip to content

Create publishing-validate Claude Code skill #48

@AlexMikhalev

Description

@AlexMikhalev

Parent

Epic: #43

Problem

Need a Claude Code skill (.md format in terraphim-skills) that agents can invoke to run the full publishing validation pipeline from within a Claude Code session.

Proposed Skill

File: skills/publishing-validate.md

This skill would:

  1. Detect the active title from ~/.config/terraphim/kg/.active-title
  2. Run the TinyClaw publishing-validate skill (Create publishing-validate TinyClaw skill definition #44) OR fall back to derive-all.sh
  3. Parse the JSON output and present a summary to the agent
  4. Flag any coverage warnings, avoid-term violations, or connectivity issues
  5. Suggest corrective actions for each type of issue

Invocation

/publishing-validate                              # uses active title
/publishing-validate context-graphs-for-engineers  # explicit title

Output Format

Publishing Validation Report: Context Graphs for Engineers
==========================================================

Model Validation: PASS (21 terms, 20 relationships, 0 issues)
Vocabulary: Generated (derived-vocabulary.md)
KG Entries: Generated (12 entries in kg/publishing/context-graphs-for-engineers/)
Mermaid: Generated (derived-concept-map.md)
Glossary: Generated (appendix-glossary.md)

Manuscript Validation: 3 warnings
  - ch03: synonym drift "Decision Record" should be "Decision trace" (line 42)
  - ch05: term "operational kg" is in avoid list for "context graph" (line 118)
  - ch07: orphan term "drift_detection" defined but not used

Coverage:
  ch01: 85% (6/7 terms) -- PASS
  ch02: 92% (11/12 terms) -- PASS
  ch03: 60% (3/5 terms) -- REVIEW (below 70% threshold)

Terraphim Graph:
  Connectivity: PASS (all terms reachable)
  Cross-contamination: 1 warning (ch05 definition uses avoided term)

Dependencies

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions