jmagly Media Curator Framework — Quick Reference
This is your always-loaded directory for the AIWG media-curator framework. It does not list every skill. Instead, it teaches the framework's mental model and gives you curated search phrases that map to aiwg discover lookups.
Canonical access pattern: discover → show
When you find a candidate via aiwg discover, fetch its body with aiwg show <type> <name>. Never use find, ls, Glob, or direct Read on <provider>/skills/ paths — those reflect the kernel-pivot deploy state, not the full surface.
aiwg discover "<phrase>" # find — returns ranked candidates
aiwg show skill <name> # fetch — streams the SKILL.md body
If your platform's Skill tool errors on a non-kernel skill (expected — most aren't kernel), the fallback is aiwg show, never filesystem browsing. Last-resort if aiwg itself is broken: read directly from $AIWG_ROOT/agentic/code/... (the canonical corpus, always present).
How to use this quickref
- Identify the capability domain the user's need belongs to
- Pick a curated phrase from that domain (or paraphrase the user's words)
- Run
aiwg discover "<phrase>"and surface the top match (or top-3) to the user
Do not enumerate skills from memory. Discovery is the lookup surface.
What this framework is for
End-to-end media archive management for audio, video, and other curated asset collections. It can inspect the requested collection type, plan a workflow, discover sources across YouTube/Internet Archive/Bandcamp or other relevant surfaces, acquire with proven tools, score quality, apply consistent metadata, generate gap notes for missing content, verify integrity with SHA-256, transcribe acquired audio/video, and export to platform-specific formats (Plex, Jellyfin, MPD, mobile, archival).
Capability domains
| Domain | Covers |
|---|---|
| Assess & plan | Inspect arbitrary collection requests, examples, filenames, metadata, source URLs, and select workflow/tooling |
| Catalog planning | Artist discography analysis, canonical catalog structure |
| Discovery & acquisition | Find sources, download with quality scoring, yt-dlp / Internet Archive patterns |
| Transcription | Timestamped transcript sidecars for acquired audio/video |
| Metadata & assembly | Tag files, embed cover art, assemble compilations |
| Completeness & gaps | Audit collection completeness, document missing content |
| Integrity & export | SHA-256 verification, platform-specific export bundles |
| Provenance | Track derivation chains, source, license, and integrity records for curated assets |
| Research handoff | Pass acquired media plus transcripts into research-complete induct-media |
Curated discovery phrases
Catalog planning
aiwg discover "curate arbitrary media collection" # → curate
aiwg discover "assess unsupported media type" # → curate / provenance-tracking
aiwg discover "analyze artist discography" # → analyze-artist
Discovery & acquisition
aiwg discover "find media sources" # → find-sources
aiwg discover "acquire media" # → acquire
aiwg discover "youtube acquisition" # → youtube-acquisition (pattern reference)
aiwg discover "archive acquisition" # → archive-acquisition (pattern reference)
aiwg discover "audio extraction" # → audio-extraction (pattern reference)
aiwg discover "quality filter media" # → quality-filtering
Transcription & research handoff
aiwg discover "transcribe media" # → transcribe-media
aiwg discover "speaker diarization audio" # → diarize-media
aiwg discover "media research handoff" # → induct-media (research-complete)
aiwg discover "video audio research induction" # → transcribe-media / diarize-media / induct-media
Metadata & assembly
aiwg discover "tag media collection" # → tag-collection
aiwg discover "metadata tagging" # → metadata-tagging (pattern reference)
aiwg discover "cover art embedding" # → cover-art-embedding (pattern reference)
aiwg discover "assemble compilation" # → assemble
Completeness & gaps
aiwg discover "check collection completeness" # → check-completeness
aiwg discover "gap documentation" # → gap-documentation
Integrity & export
aiwg discover "verify archive integrity" # → verify-archive (score 0.73)
aiwg discover "integrity verification" # → integrity-verification
aiwg discover "export media collection" # → export (score 1.00)
Orchestration & provenance
aiwg discover "curate" # → curate (end-to-end orchestrator)
aiwg discover "provenance tracking" # → provenance-tracking
Workflow shape
assess request and examples →
analyze-artist or type-specific plan →
find-sources (discovery) →
quality-filtering (accept/reject) →
acquire (download) →
tag-collection (metadata) →
verify-archive (integrity) →
export (target platform)
gap-documentation and check-completeness run cross-cutting at any stage.
For unknown or lightly supported asset types, first inspect available examples, filenames, metadata, source URLs, and user intent. Prefer established libraries or tools; create narrow custom tooling only when necessary. If specialized handling is missing, produce a concrete plan, collect safe metadata/provenance and integrity records, and identify the follow-up tool or plugin needed.
Artifact directory layout
.aiwg/media/
├── catalogs/ # Per-artist canonical discographies
├── sources/ # Discovery output (ranked candidates)
├── acquisitions/ # Acquired files + checksums
├── transcripts/ # Transcript sidecars for acquired audio/video
├── gaps/ # GAP-NOTE markers for missing content
├── exports/ # Platform-specific export bundles
└── verify/ # Integrity reports
When the curated phrases don't fit
aiwg discover "<your need, paraphrased>" --limit 5
Anti-pattern: don't enumerate
If a user asks "what media skills are available?", do not list from this skill. Run:
aiwg discover --type skill --limit 20 "<their interest area>"