shiplog skill
A skill that keeps discussion and decisions in GitHub issues and PRs so the next agent session picks up where you stopped.
- 56 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The skill creates and edits issues, comments and pull requests in your repository through `gh`, and your words are stored in public or private GitHub.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/shiplogDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The skill creates and edits issues, comments and pull requests in your repository through `gh`, and your words are stored in public or private GitHub.
This is third-party code. Review the repository files before installing.
What it does
shiplog turns GitHub issues and pull requests into project memory for agent work. It keeps three records. The first stores your discussion verbatim, in order and unedited: rejected ideas and doubts stay, and corrections are added as new entries. The second, one current summary in the tracking issue body, holds the goal, decisions linked to their source, tasks, checks and the next action. The third is a small index with a short envelope in comments. The `shiplog-read.sh` script reads the index, shows the summary and the exact discussion text and searches issues, PRs and local commits. You can work in plain phrases: save this idea, work on #42, what did I say about auth. The `/shiplog:plan`, `/shiplog:start`, `/shiplog:pr` and other commands come with the Claude Code plugin install.
Who it is for. People who plan and build with coding agents and want the history of decisions to outlive the chat window.
Good fit when
- An idea was born in chat and must be saved with your own words and doubts.
- Work runs for several days and a new agent session should read a summary rather than a retelling.
- A week later you need to recall what was decided about auth and why.
- A pull request should link to the discussion it grew from.
Not a fit when
- There is no GitHub repository: the skill relies on `gh` and a remote repository.
- You need branch protection: the skill gives none, so use GitHub required checks.
- You need an always-running service: the skill is only a set of instructions for an agent.
Example request
Save this idea as an issue with the verbatim discussion, then pick up #42 and update the summary.Limitations
`gh` authenticated with `gh auth login`, `git` in a repository with a GitHub remote and, for the helper, `bash` and POSIX tools such as `awk` and `sed` are required; Git Bash works on Windows. The skill cannot capture messages the runtime does not show the agent: such gaps are recorded, not reconstructed. Model identity on a review is declared, not proven. Only records from repository owners, members and collaborators count. Routing, cross-model review and quiet logging options are off by default.
How to disable. Remove the skill with the manager command or by deleting its folder and the plugin through the plugin manager. Created issues, comments and PRs stay in GitHub as ordinary records.
FAQ
How do I install shiplog?
`npx skills add devallibus/shiplog --skill shiplog`. Add `--agent claude-code`, `--agent codex` or `--agent cursor` for one agent, and `npx skills update` refreshes what is installed.
How do I install the Claude Code plugin?
Run `/plugin marketplace add devallibus/shiplog`, then `/plugin install shiplog@shiplog`. The plugin adds `/shiplog:plan`, `/shiplog:start`, `/shiplog:capture`, `/shiplog:commit`, `/shiplog:pr`, `/shiplog:lookup`, `/shiplog:hunt`, `/shiplog:resume`, `/shiplog:review` and `/shiplog:models`.
What are the three records?
The verbatim discussion, one current summary in the issue body and a small index with a short envelope in comments.
How do I find an old decision?
Say what did I say about auth or run `shiplog-read.sh search "auth"`. The script returns one line per issue, PR and commit, and `shiplog-read.sh source 42` gives the exact discussion text.
What is on by default?
Only discussion capture, the summary and the index. Model routing, cross-model review, verification profiles and quiet logging stay off until you enable them.
Discussion
No questions or reviews yet.
Related
SkillsA Claude Code template: each session checks the last one's notes against git and GitHub, picks the day task and writes a handoff.
Table Skills: project-handoff
Table Skills (project-handoff)
The project-handoff skill saves goals, decisions and the next step to PROJECT_STATE.md for a fresh Codex or Claude Code session
The CLI turns a coding-agent session into a shareable page with conversation, tool activity, files and a diff.
Eight Claude Code skills for Obsidian: Granola notes, NotebookLM imports, TaskNotes tasks, recall of past sessions, chat export
Skill that reads your prompt history, finds the asks you repeat and turns each into a short command such as /sent
An Obsidian vault with skills for work meetings: Gmail transcripts, participants, follow-up tasks and weekly recaps.
README in short
The README explains the three records, shows a markup sample and index read commands. A working day with the skill, optional features, limits and requirements follow.