our-claude-skills/custom-skills/90-reference-curator/commands/markdown-exporter.md

description, argument-hint, allowed-tools

description	argument-hint	allowed-tools
Export approved content to markdown files or JSONL for fine-tuning. Generates structured output with cross-references.	<format> [--topic slug] [--min-score 0.80]	Read, Write, Bash, Glob, Grep

Markdown Exporter

Export approved content to structured formats.

Arguments

• <format>: project_files | fine_tuning | knowledge_base
• --topic: Filter by topic slug (e.g., "prompt-engineering")
• --min-score: Minimum quality score (default: 0.80)

Export Formats

project_files (Claude Projects)

Output structure:

~/reference-library/exports/
├── INDEX.md                    # Master index
└── {topic-slug}/
    ├── _index.md               # Topic overview
    ├── {document-1}.md
    └── {document-2}.md

INDEX.md format:

# Reference Library Index

Generated: {timestamp}
Total Documents: {count}

## Topics

### [Prompt Engineering](./prompt-engineering/)
{count} documents | Last updated: {date}

### [Claude Models](./claude-models/)
{count} documents | Last updated: {date}

Document format:

---
source: {source_name}
url: {original_url}
credibility: {tier}
quality_score: {score}
exported: {timestamp}
---

# {title}

{structured_content}

## Related Documents
- [Related Doc 1](./related-1.md)
- [Related Doc 2](./related-2.md)

fine_tuning (JSONL)

Output: ~/reference-library/exports/fine_tuning_{timestamp}.jsonl

{"messages": [
  {"role": "system", "content": "You are an expert on AI and prompt engineering."},
  {"role": "user", "content": "Explain {topic}"},
  {"role": "assistant", "content": "{structured_content}"}
]}

knowledge_base (Flat)

Single consolidated file with table of contents.

Export Process

1. Query Approved Content

SELECT dc.*, d.title, d.url, s.source_name, s.credibility_tier, t.topic_slug
FROM distilled_content dc
JOIN documents d ON dc.doc_id = d.doc_id
JOIN sources s ON d.source_id = s.source_id
LEFT JOIN document_topics dt ON d.doc_id = dt.doc_id
LEFT JOIN topics t ON dt.topic_id = t.topic_id
WHERE dc.review_status = 'approved'
  AND (SELECT MAX(quality_score) FROM review_logs WHERE distill_id = dc.distill_id) >= ?;

2. Generate Cross-References

Find related documents by:

• Shared topics
• Overlapping key concepts
• Same source

3. Write Files

mkdir -p ~/reference-library/exports/{topic-slug}

4. Log Export Job

INSERT INTO export_jobs
  (export_name, export_type, output_format, topic_filter,
   min_quality_score, output_path, total_documents, status)
VALUES
  (?, ?, ?, ?, ?, ?, ?, 'completed');

Configuration

From ~/.config/reference-curator/export_config.yaml:

output:
  base_path: ~/reference-library/exports/
  project_files:
    structure: nested_by_topic
    include_metadata: true
quality:
  min_score_for_export: 0.80
  auto_approve_tier1_sources: true

Example Usage

/markdown-exporter project_files
/markdown-exporter fine_tuning --topic prompt-engineering
/markdown-exporter project_files --min-score 0.90