Agent Figure Gallery
Designagent-figure-galleryAgent Figure Gallery is an Agent Skill for design published in the Dsadd4/AgentFigureGallery repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Query visual scientific figure references, show candidates for human preference selection, export selected reference bundles, and guide plotting agents from human-selected visual examples to code action.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/Dsadd4/AgentFigureGallery/blob/HEAD/skills/agent-figure-gallery/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/agent-figure-gallery, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Agent Figure Gallery
Core Rule
Treat this skill as a lightweight controller. Do not load the full visual corpus into the skill. Use AGENT_FIGURE_GALLERY_ROOT or DRAWING_KB_ROOT to point at the external AgentFigureGallery knowledge base.
Key Files
- KB root:
AGENT_FIGURE_GALLERY_ROOT=/path/to/AgentFigureGallery - CLI:
agentfiguregalleryorpython -m agentfiguregallery.cli - Gallery server: backend command that serves the reference gallery on localhost
- Candidate index:
data/reference_candidate_index.json - Global preferences:
data/reference_global_preferences.json - Reference sessions:
outputs/reference_sessions/
Minimal Workflow
- Resolve the KB root:
export AGENT_FIGURE_GALLERY_ROOT=/path/to/AgentFigureGallery - Query before reading individual references:
agentfiguregallery query --task "<user task>" - Generate visible candidates:
agentfiguregallery gallery --plot-type <plot_type> --task "<user task>" --limit 50 --serve - Record human preferences:
agentfiguregallery prefer --session outputs/reference_sessions/<session_id> --like <ID> --reject <ID> --select <ID> - Export a selected bundle:
agentfiguregallery bundle --session outputs/reference_sessions/<session_id> --copy-scripts - Use the bundle before writing or revising plotting code.
Preference Semantics
like: useful for this task or plot type.reject: not useful for this task or plot type.select: use this candidate for the current agent action.global_like: generally useful across tasks.global_reject: hide from future sessions.
Local preferences must preserve plot_type. Global preferences are cross-task.
Validation
After changing the CLI, gallery, preference logic, or bundle export:
agentfiguregallery gallery --plot-type embedding_plot --limit 20 --serve
agentfiguregallery prefer --session outputs/reference_sessions/<session_id> --like E01 --select E02
agentfiguregallery bundle --session outputs/reference_sessions/<session_id>
Success means visible candidates render, stable IDs are shown, preferences persist, global rejects are hidden from later generated sessions, and the bundle contains selected references plus source code paths.