Dg Obsifetch

Digital Garden - obsifetch Tribute

A neofetch for your vault. Renders a build-time stats readout of an Obsidian Digital Garden as both a curl-able /neofetch.txt route and a styled HTML card - a tribute to the tabibyte/obsifetch Obsidian plugin, which does the same thing inside the app.

When to Use This Skill

Use when a DG user wants an obsifetch / neofetch-style vault readout: a site-stats colophon, a /neofetch.txt route, or a footer stats card showing file counts, sizes, orphan files, internal links, and theme. Common state on real sites: the text route + data engine work, but the HTML embed was left unfinished - this ships the finished card.

Do not use on non-DG stacks (Quartz, Astro, plain Eleventy) - the notes layout, theme env vars, and theme tokens are DG-specific.

DG invariants respected

1. User-owned paths only. Everything lands in user territory:

_data/vaultStats.js, root page neofetch.txt.njk, footer component components/user/common/footer/zz-obsifetch.njk, and appended custom-style.scss. No layout / plugin-core edits.

1. Autoload, don't wire. The card uses the footer slot + zz- prefix

(sorts late). No layout edit.

1. Theme via tokens. Card + swatches inherit DG theme variables; light/dark

automatic. Colors are never hardcoded (except documented swatch fallbacks).

1. Accessibility. Decorative ASCII is aria-hidden; stats are a real ``;

card is rendered inline (works with JS off).

1. Consolidated knobs. All sizes + the swatch palette live in one :root

block atop the SCSS.

Prerequisites (verify first)

• An Obsidian Digital Garden (oleeskild plugin + Eleventy) repo with the

user-component autoloader (_data/dynamics.js globbing components/user/common/footer/).

• Standard DG tree: src/site/notes, optional src/site/files,

src/site/img.

• THEME / BASE_THEME env vars set by your DG build (for the theme line) -

optional; degrades to default / light.

Abort with a plain explanation if the target isn't DG + Eleventy with the autoloader.

Instructions

1. Data engine. Copy assets/vaultStats.js →

src/site/_data/vaultStats.js. Set SITE_DOMAIN (env) or edit the fallback domain string.

1. Text route. Copy assets/neofetch.txt.njk → src/site/neofetch.txt.njk

(route /neofetch.txt). Customize the ASCII if you like - keep the tabibyte/obsifetch credit line.

1. HTML card. Copy assets/zz-obsifetch.njk →

src/site/_includes/components/user/common/footer/zz-obsifetch.njk. Keep its ASCII in sync with the text route.

1. Styles. Append assets/obsifetch.scss to

src/site/styles/custom-style.scss (TUNING KNOBS block at top).

1. Build and verify with references/verify.md: curl /neofetch.txt, check

the card renders with matching stats and 8 theme swatches.

Trims (text-only, card-only, hide swatches) are in references/tuning.md.

Key Design Points

• One data source, two surfaces. vaultStats.js computes once at build;

both the text route and the card read vaultStats. Stats always agree.

• Finishes the classic unfinished embed. The common half-done state is a

working /neofetch.txt but no visual embed. This ships a proper inline card (no client fetch, no loading flash, JS-off safe) instead of a fetch-into-``.

• Swatches track the theme. 8 squares map to DG theme tokens via

--ob-c1..c8; they follow light/dark and any theme swap for free.

• It's a tribute - keep the credit. Both surfaces cite

tabibyte/obsifetch.

Risk Level

L2. Beyond writing user-owned files, this adds a build-time data file that recursively reads your notes/files/img trees to compute stats. It is read-only - no network, no writes, no plugin-core edits - and fully reversible via git. Review assets/vaultStats.js before adding it.

Reference Files

• references/architecture.md - data engine, the two surfaces, swatch mapping,

config surface.

• references/tuning.md - every SCSS/content knob + trims.
• references/verify.md - data, text-route, card, theme/a11y, and attribution

checks.

Assets

vaultStats.js, neofetch.txt.njk, zz-obsifetch.njk, obsifetch.scss.

Validate & Package

npx skills-ref validate skills/dg-obsifetch/
zip -rq dg-obsifetch.zip dg-obsifetch

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: palol
• Source: palol/skills-zoo
• License: MIT
• Homepage: http://skillz.paologabriel.com/

Install and usage instructions live in the source repository linked above.