Ducktor plugin
A mentor plugin for research papers: duck commands take the agent from survey to review and explain its decisions.
- 55 ★ on the repository
- Last commit
Minimal access
Why this level
- The plugin registers hooks and writes `.duck/` files into the project but calls no external services itself.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/ducktorDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The plugin registers hooks and writes `.duck/` files into the project but calls no external services itself.
This is third-party code. Review the repository files before installing.
What it does
Ducktor is a plugin for Claude Code and Codex that adds a methodology layer to research work with an agent. The commands `/duck-survey`, `/duck-idea`, `/duck-outline`, `/duck-intro`, `/duck-write`, `/duck-figure`, `/duck-polish` and `/duck-review` take a paper from literature survey to a mock review. `/duck on` makes the agent explain its decisions and record what the human chose versus what the agent did. `/duck-why` dissects the last step and names the principle, and `/duck-learn` recaps a stage and finds decisions handed to the agent unnoticed. Principles accumulate in `.duck/notebook.md`. Before results go into the text, the agent checks whether repeated runs support them.
Who it is for. Graduate students and researchers who write papers with an agent and do not want to skip methodology: justification, number checks and honest review.
Good fit when
- Experiments are done and the agent must write the paper without calling a result significant after a single run.
- Before submission a strict mock review from a top conference reviewer's view is needed.
- You want to know why the agent built the introduction as it did and save the principle in notes.
- After a stage you need to find which decisions the agent made on your behalf.
Not a fit when
- The text is not scientific: the commands target papers and experiments.
- An agent is wanted that writes and submits the work without your involvement.
- The session starts in a subfolder such as `paper/`: settings are read only from the project root.
Example request
/duck-write: write the experiments section from the results in results/ and first check that every number is backed by several runs.Limitations
Documentation is in Chinese, with an English version at `i18n/README.en.md`. The project is in early preview. Node.js 18 or newer is needed. For Codex, open `/hooks` after installing and trust the two registered hooks, and in other tools a copy of `AGENTS.md` works without slash commands. The licence is mixed: MIT, CC BY-NC-SA 4.0 and CC BY 4.0 for different parts, so read its section before commercial use of the materials.
How to disable. In Claude Code run `claude plugin uninstall duck@ducktor`, in Codex remove the plugin and revoke hook trust in `/hooks`. The `.duck/` directory in the project is deleted by hand.
FAQ
How does `/duck on` differ from normal work?
The agent explains its reasons, records who decided what and checks three things, including repeated runs, before putting numbers into text.
Does it work in Cursor or Gemini CLI?
Yes, in reduced form: copy `AGENTS.md` into the project and the standing rules apply. There are no slash commands, so invoke workflows in words.
What is stored in `.duck/`?
The mode configuration and the `notebook.md` principle notebook that collects conclusions after `/duck-why` and `/duck-learn`.
Which commands does a paper need?
Nine workflow commands from `library/`: survey, idea, human-agent boundary, outline, introduction, text, figures, polish and review. The full list is in the README commands section.
Are keys or services needed?
No. The plugin consists of skills and hooks and needs only Node.js 18 or newer.
Discussion
No questions or reviews yet.
Related
PluginsA Claude Code skill for scientific literature reviews: an interview, Scopus and OpenAlex search, DOI checks and a final docx file
A marketplace of five Claude Code plugins for researchers: literature search, research design, project memory and manuscript work
A plugin for studying research papers: a PDF or arXiv link becomes a summary, study materials, code demos and a web viewer
35 skills for Claude Code and Codex lead a social scientist from idea to a journal manuscript, with scans of participant data.
A ready-to-fork Claude Code template for academic work: slides, papers and data analysis with multi-agent review and quality gates
Two skills for Claude Code and Codex: the agent translates papers in the EasyRead library and answers your margin notes
README in short
Explains the methodology idea for research work with an agent, modes, commands, repository layout, installation for Claude Code and Codex, and usage questions.