Skip to content

docs(skills): align skills with updated Substreams docs and performance guidelines - #25

Merged
maoueh merged 1 commit into
developfrom
docs-alignment-performance
Oct 30, 2026
Merged

maoueh merged 1 commit into
developfrom
docs-alignment-performance

Conversation

@joshkauffman

Copy link
Copy Markdown
Contributor

Summary

Aligns the skills with the current docs.substreams.dev, most notably the new Performance Guidelines page.

Contradictions fixed

  • Block filtering now leads with raw Block + blockFilter on a foundational index; custom blockIndex only when several modules filter on it; filtered_* is an alternative (extra module, no tx context, params override still required). Notes blockFilter is block-level.
  • "Smaller, focused modules perform better" reversed: keep module count small.
  • blocks_without_votes no longer recommended (endpoints don't serve votes).
  • Short name@version imports documented as working on CLI >= 1.20.0 (older CLIs need the spkg.io URL).
  • package.image is the registry icon path, not a container image.

Added

  • substreams-dev/references/performance.md, updating-packages.md
  • manifest-spec: use:, foundational-store:, descriptorSets, binaries[].build, registry imports
  • Partial blocks / protocol v4 (sink), standby sinks (deploy-local), Solana versioned tx, delta-op notes (sql), module-cache notes (testing), EVM eth_call / Foundational Store guidance

Notes

  • Not covered: chain tutorials (Stellar/TRON/Monad/World Chain/Injective), Yellowstone migration, Hardhat/Foundry/Anchor guides, community sinks, progress-info page.
  • npm run validate passes. Guidance was not exercised against a CLI/build.
  • Local CLI (1.18.4) is older than the 1.20.0 gate; the gate comes from the docs changelog.

🤖 Generated with Claude Code

…elines

- Lead block filtering with a foundational index + raw Block; custom
  blockIndex only when several modules filter on it; filtered_* as alternative
- Keep module count small (reverse "smaller modules perform better")
- Add performance.md and updating-packages.md references
- Version-gate short registry imports (CLI >= 1.20.0); drop
  blocks_without_votes; fix package.image description
- Add manifest use:/foundational-store/descriptorSets, partial blocks,
  standby sinks, Solana versioned transactions, module cache notes

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@maoueh
maoueh merged commit 8959b1a into develop Oct 30, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants