almagest
nathanaday/almagest/AGENTS.md
Read README.md and CLAUDE.md before you change this repository. CLAUDE.md holds the architecture, the invariants, and the build instructions for both agents.
One search for your own team's files and the public ecosystem. See how real projects write their agent instructions, and bring the good ideas home.
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
nathanaday/almagest/AGENTS.md
Read README.md and CLAUDE.md before you change this repository. CLAUDE.md holds the architecture, the invariants, and the build instructions for both agents.
nathanaday/almagest/CLAUDE.md
Almagest: the Go module github.com/nathanaday/almagest (binary almagest) and the agent plugin almagest in the repository's own marketplace. The Obsidian plugin lives in its own repository, obsidian-almagest (~/projects/software/obsidian-almagest), and reaches users only through Obsidian's community plugins. Read README.md and docs/guide.md first. This file holds what the code and those do not say. - The binary serves the MCP tools (internal/mcpserver), the hooks (internal/hooks), and the CLI (internal/cli). The vault, its index, and the write transaction are internal/vault; changes are internal/change. -…
nathanaday/almagest/skills/almagest-onboard/SKILL.md
Make a new Almagest vault: ask its name, its folder, and how freely to tag, then link its first repositories. Use for set up almagest, new vault, start a vault here, onboard, make this folder a vault. Linking a repository to a vault that exists is repo-link.
nathanaday/almagest/skills/almagest/SKILL.md
Orient in the Almagest vault, say what waits for the user, do the work a request asks in a linked repository, and route any other request to the skill that owns it. Use for /almagest, what is going on, status, what waits for me, where do I work on X, work on X, fix this, implement, build, note this, remember to, publish my journal, what is in my journals, and any request when the right skill is not clear. Keeping part of this conversation is wiki-save; files to learn from are wiki-ingest.
nathanaday/almagest/skills/repo-ingest/SKILL.md
Describe a linked repository in the wiki from its code: its components, design patterns, conventions, and open issues, and bring the description up to date after the code moves on. Use for describe this repository, map the repo, ingest the codebase, the repository document is behind, what is in this repo. Linking a repository is repo-link; ingesting a file or a paper is wiki-ingest.
nathanaday/almagest/skills/repo-link/SKILL.md
Link a git repository on this machine to the vault: a repository document that points at it, with its category tags and its own tag, written as one change. Use for link this repository, add a repo, work with ~/code/x, connect a repository. Describing its code is repo-ingest; unlinking is repo-unlink.
nathanaday/almagest/skills/repo-unlink/SKILL.md
Unlink a repository from the vault: mark its document unlinked, and decide what happens to the topics under its tag. The document stays, so every link to it holds. The repository on disk is never touched. Use for unlink, remove this repository, forget this repo, the repository moved away. Linking is repo-link.
nathanaday/almagest/skills/wiki-checkout/SKILL.md
The librarian: choose the wiki documents that serve a request, follow their links only while the documents still serve it, and check out copies with a reading list in reading order. Return proposes the user's edits of the copies as one change. Use for check out the material on X, pull together what we know about X, make me a reading stack on X, a reading list on X, return my checkout. An answer to a question is wiki-query.
nathanaday/almagest/skills/wiki-edit/SKILL.md
Change knowledge that exists: rewrite, rename, merge, split, remove with a redirect, retag, confirm a topic is current, or repair what lint found, as one reviewed change; and draft the topic of a subject that a wikified note marks as new, or that the user selects in a note with Make topic. Use for rewrite this topic, rename, merge these topics, split this topic, tag this under p3, rename a tag, this page is still right, fix the lint findings, fix the dead links, draft a topic titled X from this note. New knowledge from documents is wiki-sync; unlinking a repository is repo-unlink.
nathanaday/almagest/skills/wiki-ingest/SKILL.md
Triage what waits in ingest/, and capture what the wiki should learn from: each item goes to the wiki as a source, or to a note in scratchpad/ when it holds work or an idea. Use for ingest, process ingest/, process the inbox, add this file to the wiki, read and file this, batch ingest. Saving part of this conversation is wiki-save; an idea to act on later is a note in scratchpad/ (the almagest skill).
Often used withwiki-capturewiki-reviewwiki-update
nathanaday/almagest/skills/wiki-map/SKILL.md
Map a tag from the documents under it: write or refresh its overview topic; group the topics directly below its page under hub topics and set their up; where two child tags hold one subject, widen the topic's tags to the parent; where they hold related subjects, bridge them with a topic under the parent. Use for organize the wiki, map this tag, the page is crowded, group these topics, what do these repositories share, map the relationships, write the page for this tag, lift this to p3. Renaming or merging a tag is wiki-edit.
nathanaday/almagest/skills/wiki-query/SKILL.md
Answer a question from the wiki, with citations, and say what the wiki does not cover. Reads only. Use for what does the wiki say, explain from my notes, find in the wiki, what do we know about X, which repositories use Y. Keeping the answer is wiki-save; a reading list of the documents on a subject is wiki-checkout.
Often used withwiki-capturewiki-update
nathanaday/almagest/skills/wiki-review/SKILL.md
The health of the wiki. Quick: the deterministic checks of lint, read and explained. Deep: reviewer agents that read the topics for gaps, errors, contradictions, and stale or mistagged topics. Use for lint, wiki health, audit the wiki, review the wiki, deep review, what is wrong with the wiki, tidy the tags. The repairs are wiki-edit.
nathanaday/almagest/skills/wiki-save/SKILL.md
Keep something from this conversation in the wiki: an answer, a decision, a comparison, a finding, cited to this session. Use for save this, keep this answer, file this decision, remember this in the wiki. Files are wiki-ingest; an idea to act on later is a note in scratchpad/ (the almagest skill).
nathanaday/almagest/skills/wiki-sync/SKILL.md
Absorb sources into the wiki through one pipeline: chunk, extract, match, draft, change. It serves every way knowledge enters: a captured file, a repository snapshot, a saved passage, a published journal edition. Use for sync the wiki, absorb the pending sources, update the wiki from this source, what does the wiki still need to learn. Capturing files is wiki-ingest; changing topics that exist is wiki-edit.
nathanaday/almagest/skills/wiki-wikify/SKILL.md
Experimental. Mark a copy of the user's note with what the wiki knows: a link mark where a phrase names a document of the wiki, and a new mark where it names a subject worth a topic. The user accepts or ignores each mark in Obsidian; nothing enters the wiki by itself. Use for wikify this note, review this doc, link this draft to the wiki, what in this note does the wiki know. Drafting the topic of a new subject is wiki-edit; files to learn from are wiki-ingest.
nathanaday/atlas-obsidian/CLAUDE.md
Almagest: the Go module github.com/nathanaday/almagest (binary almagest) and the agent plugin almagest in the repository's own marketplace. The Obsidian plugin lives in its own repository, obsidian-almagest (~/projects/software/obsidian-almagest), and reaches users only through Obsidian's community plugins. Read README.md and docs/guide.md first. This file holds what the code and those do not say. - The binary serves the MCP tools (internal/mcpserver), the hooks (internal/hooks), and the CLI (internal/cli). The vault, its index, and the write transaction are internal/vault; changes are internal/change. -…
nathanaday/atlas-obsidian/skills/almagest/SKILL.md
Orient in the Almagest vault, say what waits for the user, do the work a request asks in a linked repository, and route any other request to the skill that owns it. Use for /almagest, what is going on, status, what waits for me, where do I work on X, work on X, fix this, implement, build, note this, remember to, publish my journal, what is in my journals, and any request when the right skill is not clear. Keeping part of this conversation is wiki-save; files to learn from are wiki-ingest.
nathanaday/atlas-obsidian/skills/wiki-edit/SKILL.md
Change knowledge that exists: rewrite, rename, merge, split, remove with a redirect, retag, confirm a topic is current, or repair what lint found, as one reviewed change; and draft the topic of a subject that a wikified note marks as new. Use for rewrite this topic, rename, merge these topics, split this topic, tag this under p3, rename a tag, this page is still right, fix the lint findings, fix the dead links, draft a topic titled X from this note. New knowledge from documents is wiki-sync; unlinking a repository is repo-unlink.
nathanaday/atlas-obsidian/skills/wiki-map/SKILL.md
Map a tag from the documents under it: write or refresh its overview topic; where two child tags hold one subject, widen the topic's tags to the parent; where they hold related subjects, bridge them with a topic under the parent. Use for organize the wiki, map this tag, what do these repositories share, map the relationships, write the page for this tag, lift this to p3. Renaming or merging a tag is wiki-edit.
Plain text files in a repository that tell a coding agent how the project works: commands to run, conventions to follow and things to avoid. CLAUDE.md, AGENTS.md, cursor rules and skills are the common kinds.
CLAUDE.md is read by Claude Code. AGENTS.md is an open format that Codex, Cursor and other agents read. Many projects keep one and point the other at it.
A folder with a SKILL.md that describes one capability, such as filling PDFs or reviewing code. The agent loads it only when the task calls for it.
Your agents already can, over MCP, limited to the files you're allowed to read. Searching them from this page is coming.