How do I install the Almanac skill?

Run npx skillmds@latest add cjohnhanson/almanac in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Almanac safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Almanac?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Almanac free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Almanac?

cjohnhanson (@cjohnhanson) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Almanac by cjohnhanson — Agent Skill

Name: Almanac
Author: cjohnhanson

Almanac

Curate a pinned, review-gated library of agent skills with almanac. Vendor skills from git repos or local paths into a manifest-governed directory, detect drift, gate updates behind diffs and red-flag scans, and print a markdown skills index for context injection. Use when adding a skill to a repo's curated library, checking library integrity, or updating pinned skills.

cjohnhanson eaf9ac0 1.4 KB Updated Sep 17, 2026

File contents

almanac

almanac.yml governs the library directory next to it. Almanac pins every vendored skill to a commit and a content hash, and it stamps every vendored directory. No change lands without a report.

Rules

Never edit a file inside a vendored skill directory. Fix it upstream and run almanac update <name>, or use a dev: source to iterate locally.
Run almanac add <source> to stage a skill and print its red-flag report. Nothing lands without --accept. Read the report; the flags are signals, not verdicts.
Run almanac sync --check to verify the library. It exits 1 when a pinned entry drifts. It skips dev: snapshots.
Run almanac status to see the pin and drift state of every entry. It also lists unmanaged neighbor directories, which almanac never touches.

Common calls

almanac add github:owner/repo --path skills/name --accept
almanac add dev:../myrepo/skills/name --accept
almanac update [name] --yes
almanac index --md --max-bytes 4096   # gaff prime-section payload
almanac show <name>

Frequently asked questions