| name | x-ipe-knowledge-present-to-user |
| description | Knowledge output formatter that renders constructed knowledge as a structured summary for human consumption. Delegates rendering to scripts/render.py. Triggers on operations like "render", "present to user". |
Present to User — Knowledge Skill
Purpose
AI Agents follow this skill to render knowledge content into human-consumable formats:
- Read knowledge content from a source file
- Parse into sections with completeness tracking
- Flag incomplete sections with warnings
- Output as structured JSON or Markdown
Important Notes
BLOCKING: This is a single-operation skill. The render operation reads a content file and produces formatted output.
CRITICAL: This skill is NOT directly task-matched. It is called by the Knowledge Librarian assistant (x-ipe-assistant-knowledge-librarian-DAO).
CRITICAL: Operations are stateless services — the orchestrator passes full context per call.
CRITICAL: The default output format is structured JSON (BR-5). Markdown and other formats are only used when explicitly requested by the caller.
About
This skill formats knowledge content for human consumption. It parses Markdown-based knowledge files, tracks section completeness (detecting [INCOMPLETE: ...] markers left by the constructor's fill_structure operation), and produces either a structured JSON summary or a Markdown-formatted output.
Key Concepts:
- Structured Summary — Default output: JSON with
title, summary, sections[], and metadata. Each section includes heading, content, completeness percentage, and optional warnings[].
- — Measures the ratio of filled content to markers per section, producing a percentage (0–100).
