Artifact Pyramids

What it does

When your agent uses it

• Agent Workflows work in your project

Example prompts

• “/artifact-pyramids”

Requirements

• Python 3
• Compatibility (from SKILL.md): Agent-agnostic — concepts apply to any AI agent workflow. Scripts require Python 3.9+ and a POSIX shell.

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

1. 1Progressive disclosure is symmetric. The same three-tier model governs what agents consume (metadata → instructions → resources) and what…
2. 2Each layer is independently consumable. A product-manager agent reads only the L1 summary. A data-scientist agent reads a single L2…
3. 3Navigation is explicit. Every file carries a SOURCES section with absolute paths and descriptions — not footnotes, but agent navigation…
4. 4Depth varies by mission complexity. A simple brief may produce only L1 + 2 analysis files. A competitive landscape may need all three…
5. 5Quality gates are directional. Material moves from L3 (sources) toward L1 (summary) only when it meets the gate for the target layer.
6. 603-dossiers/ is flat — no subdirectories. The dossier layer is a flat reference library. Organize with epoch-prefixed or category-prefixed…
7. 7Root-level files are amended; lower-level files are fixed. In multi-epoch or multi-phase systems, 00-index.md, 01-summary/findings.md, and…

What it can do on your machine

Read from SKILL.md and the folder at commit 867a555. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 1 file in scripts/, which the agent can run.

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  Agent-agnostic — concepts apply to any AI agent workflow. Scripts require Python 3.9+ and a POSIX shell.

  From compatibility in the SKILL.md frontmatter.

Context cost

Artifact Pyramids loads about 2.5k tokens when it runs, and up to ~20k if it reads all its reference files. Until then it costs about 118 tokens; SKILL.md has 921 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~118

When it runs · the whole SKILL.md, loaded when a task matches

~2.5k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~20k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from magnus919/hermes-profiles at commit 867a555, republished under its MIT licence (© magnus919). 921 words, ~2,545 tokens.

name

artifact-pyramids

description

Progressive disclosure for what AI agents produce. Structure research outputs across three layers of increasing depth — Summary (key findings), Analysis Collection (per-dimension files), and Detailed Dossiers (source excerpts, raw data, transcripts) — so downstream agents and humans consume only as deeply as they need. Load this skill when organizing research outputs, building multi-agent research pipelines, or designing agent collaboration protocols.

compatibility

Agent-agnostic — concepts apply to any AI agent workflow. Scripts require Python 3.9+ and a POSIX shell.

license

MIT

metadata.spec-version

0.0.3

metadata.source

https://github.com/groktopus/artifact-pyramids

metadata.canonical-article

https://www.groktop.us/artifact-pyramid-progressive-disclosure/

      ┌──────────────┐
      │  L1 SUMMARY  │  One file: research question, key findings,
      │    🎯        │  most important implications. Links to L2 files.
      └──────┬───────┘
      ┌──────┴───────┐
      │  L2 ANALYSIS │  Per-dimension files: market, competitive,
      │  COLLECTION  │  technical feasibility, risk. Self-contained,
      │   🧩        │  each links to L3 dossiers.
      └──────┬───────┘
      ┌──────┴───────┐
      │  L3 DOSSIERS │  Source excerpts, raw data tables, interview
      │    📦        │  transcripts, methodology notes. Reference
      └──────────────┘  library, pulled on demand.

SOURCES (LAYER 2 NAVIGATION)
research/analysis/market-position.md
 -> Competitor mapping and market share analysis supporting Section 2
research/analysis/technical-feasibility.md
 -> Architecture evaluation supporting Section 3
research/dossiers/competitor-profiles.md
 -> Raw competitor data dossiers

# Scaffold a new research project with all three layer directories
mkdir -p my-project/{01-summary,02-analysis,03-dossiers}
cp assets/pyramid-template.md ./my-project/00-index.md

# Check structural coverage of an existing project
scripts/pyramid-status.sh ./my-project

# Extract candidate atoms from source text
scripts/extract-atoms.py ./my-project/03-dossiers/source-1.txt

my-project/
├── 00-index.md              # Project scaffold (from template)
├── 01-summary/              # L1: one file — key findings, implications, links to L2
├── 02-analysis/             # L2: per-dimension files (market, competitive, technical)
├── 03-dossiers/             # L3: source excerpts, transcripts, raw data, methodology
└── artifact-inventory.md    # Cross-layer tracking (from template)

© magnus919, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 24 other files (scripts, references, assets) in skills/artifact-pyramids of magnus919/hermes-profiles.

• SKILL.md
• LICENSE
• README.md
• assets/artifact-inventory.md
• assets/pyramid-template.md
• references/artifact-pyramid-framework.md
• references/canonical-article.md
• references/companion-session-summary.md
• references/composite-pyramid-synthesis.md
• references/delegation-context-template.md
• references/flat-to-pyramid-migration.md
• references/intellectual-lineage.md
• references/methodology-to-pyramid-mapping.md
• references/nested-pyramid-pattern.md
• references/output-classification-framework.md
• references/pipeline-stages.md
• references/provenance-artifacts.md
• references/quality-gates.md
• references/skillopt-baseline-pyramid.md
• … and 6 more

Open the folder on GitHubat commit 867a555