Artifact Pyramids

What it does

When your agent uses it

• Producing multi-layer research artifacts
• Coordinating research handoffs
• Unrelated requests
• Route to the nearest named specialist

Example prompts

• “/artifact-pyramids”

Requirements

• Python 3
• Compatibility (from SKILL.md): Python 3.9+ and a POSIX shell are required only for the bundled scripts.

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 9cb2f8b. 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

  Python 3.9+ and a POSIX shell are required only for the bundled scripts.

  From compatibility in the SKILL.md frontmatter.

Context cost

Artifact Pyramids loads about 2.7k tokens when it runs, and up to ~18k if it reads all its reference files. Until then it costs about 69 tokens; SKILL.md has 1,031 words of instructions outside code blocks.

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

~69

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

~2.7k

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

~18k

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/agent-skills at commit 9cb2f8b, republished under its MIT licence (© magnus919). 1,031 words, ~2,667 tokens.

name

artifact-pyramids

description

Organize durable agent research outputs as summaries, analysis, and evidence dossiers. Use when producing multi-layer research artifacts or coordinating research handoffs. Do not use this skill for unrelated requests; route to the nearest named specialist.

compatibility

Python 3.9+ and a POSIX shell are required only for the bundled scripts.

license

MIT

metadata.source_repo

https://github.com/magnus919/hermes-profiles

metadata.source_commit

867a555

      ┌──────────────┐
      │  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 22 other files (scripts, references, assets) in artifact-pyramids of magnus919/agent-skills.

• SKILL.md
• LICENSE
• README.md
• assets/artifact-inventory.md
• assets/pyramid-template.md
• evals/evals.json
• references/artifact-pyramid-framework.md
• references/canonical-article.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
• … and 5 more

Open the folder on GitHubat commit 9cb2f8b