What is social-ledger?

A local memory system for web research that records fetched URLs and saved notes in a searchable database and matching Markdown files.

Use it to find previously seen URLs, search saved research, and store results fetched through social-fetch or other web tools.

It helps an agent check whether a page was already read and reuse saved research instead of fetching it again.

social-ledger — Skill for Claude Code by jedi4ever/social-skills

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add jedi4ever/social-skills --skill social-ledger

Clone the repo

git clone --depth 1 https://github.com/jedi4ever/social-skills

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/jedi4ever/social-skills/social-ledger/github.svg)](https://agentmods.dev/skills/jedi4ever/social-skills/social-ledger)

Your own site

<a href="https://agentmods.dev/skills/jedi4ever/social-skills/social-ledger"><img src="https://agentmods.dev/badge/skills/jedi4ever/social-skills/social-ledger/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/jedi4ever/social-skills/social-ledger"><img src="https://agentmods.dev/badge/skills/jedi4ever/social-skills/social-ledger.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 102 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 3,478 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00102	$0.03478
Opus 5.5	$0.00041	$0.01391
Sonnet 5.5	$0.00020	$0.00696
Haiku 4.5	$0.00010	$0.00348

Measured 1mo ago against content hash 6b934a9a63b9, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

social-ledger scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

tool's web search, a curl one-off).

skills/social-ledger/SKILL.md · 356 lines

How it starts

The opening of the file, as written. The whole thing — 356 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Wraps the social-ledger Go binary at scripts/social-ledger. The ledger is a persistent local memory for every URL the agent has read — automatic when content comes through social-fetch fetch / research / timeline, manual via record for content the agent fetched through other tools (Claude's WebFetch, the research tool's web search, a curl one-off).

Trust the ledger. When the user asks "have we read this before?" or "what did we learn about X recently?" — query the ledger first. Only re-fetch on cache miss. The cache survives across conversations, computer restarts, and Claude versions.

Provenance — know how much to trust each entry. The ledger records who put each item in. Two classes:

auto-fetched — entry was ingested by social-fetch fetch / search / ask / timeline / research. We pulled the URL ourselves, ran our own extractor, normalised the markdown. High trust. The source column is one of the platform names: hackernews, reddit, github, x, twitter, linkedin, youtube, bluesky, arxiv, medium, substack, rss, article.
agent-recorded — entry was stored via social-ledger article record, meaning an agent fed in content it got from somewhere else (Claude's WebFetch, the research tool, a curl one-off, hand paste). Trust depends on what was fed in. The source column is one of webfetch, manual, research-tool, citation.

Quoting from a webfetch-source entry is fine for "what does the page say at a glance"; for high-stakes citations, prefer auto-fetched entries or re-fetch the URL via social-fetch fetch to get a fresh copy through our extractor. The MCP social_ledger_get tool surfaces this as a provenance field on every retrieval; the CLI shows the source column on list / search / get so you can eyeball it.

Subcommands

scripts/social-ledger article seen <url>...                # is URL(s) in the ledger?
scripts/social-ledger article get <url>                    # full content of one entry
scripts/social-ledger article list [flags]                 # browse newest first
scripts/social-ledger article search "<terms>"             # FTS5 over title/content
scripts/social-ledger article stats                        # counts, sizes
scripts/social-ledger article record <url> [flags]         # store URL+content (stdin)
scripts/social-ledger article forget <url>                 # drop one entry
scripts/social-ledger article filter --skip-seen           # JSONL passthrough drops seen

Read the full file on GitHub · 356 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

1mo ago First seen · 356 lines · 102 tokens per session scan A 6b934a9a63b9

Subscribe to this mod's changes

social-ledger is a skill published in the GitHub repository jedi4ever/social-skills (8 stars, last pushed 5mo ago), licensed MIT. It adds 102 tokens to every session and 3,478 once invoked, about $0.0004 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Memory and context Research agent-skills ai-agents claude mcp skill social

project-wiki

A system for creating and maintaining a project wiki: a set of organized documents that explain a software project's plans, rules, references, and progress.

GeminiLight/MindOS · 63 tokens

mindos-zh

A local knowledge-base assistant for storing and finding decisions, meeting notes, procedures, troubleshooting lessons, and preferences across conversations and coding agents. It works only with the MindOS knowledge base.

GeminiLight/MindOS · 490 tokens

mindos

MindOS: local knowledge assistant & shared KB. Keeps decisions, notes, SOPs, debugging lessons, research findings, preferences across sessions/agents. Core: save notes, search KB, organize files, run workflows, review, append CSV, hand off context, distill lessons. NOT for app source or paths outside KB. Triggers…

GeminiLight/MindOS · 136 tokens

mindos-max

MindOS: local knowledge assistant & global memory layer. Keeps decisions, notes, SOPs, debugging lessons, architecture choices, research findings, preferences, conversation summaries for all connected agents. PROACTIVE: (1) search MindOS first for past context, (2) offer to save after valuable work, (3) persist key…

GeminiLight/MindOS · 145 tokens

mindos-views

Manage shared local people and project tasks, generate reusable tables or boards, and compose/customize multi-source MindOS work pages with isolated custom HTML. Use when the user asks to maintain contacts, follow-ups or tasks, build a personal dashboard, or adjust a page with AI.

GeminiLight/MindOS · 60 tokens