skills.rest
mryk814
mryk814COMMUNITY
Explore all skills by this author →
GitHub

add-gallery-case

Adds Gallery cases to site_gallery.json using existing canonical IDs with validation.

Updated Jul 13, 2026
Search Tags:#optimization#knowledge base#data validation#contributor workflow#canonical ids#gallery case#json seed
One-click install
npx skills add https://github.com/mryk814/optimization-compass --skill add-gallery-case-mryk814
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-gallery-case
Source: https://github.com/mryk814/optimization-compass/tree/main/.agents/skills/add-gallery-case
Command: npx skills add https://github.com/mryk814/optimization-compass --skill add-gallery-case-mryk814

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding a new Gallery case to the Optimization Compass knowledge base requires strict consistency with existing canonical IDs and validation rules; this Skill guides that process so contributors avoid broken references and failed PR gates. ## Core Features & Use Cases - ID Verification: Confirms every referenced ID (problem archetype, method, implementation, source, visualization, comparison) already exists in the generated indexes under site/public/data/ before editing. - Guided Editing: Copies the structurally closest existing case in data/seeds/site_gallery.json and re-evaluates every copied ID rather than reusing them blindly. - Validation Workflow: Runs uv run optimization-compass validate gallery locally and validate tier-b as the PR gate, with DCO sign-off required. - Use Case: A contributor wants to document a new real-world optimization example in the Gallery; the Skill walks them through ID checks, seed editing, and validation without touching site code. ## Quick Start Add a new Gallery case for a workforce scheduling problem to the optimization-compass dataset and validate it.

Frequently Asked Questions about add-gallery-case

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new Gallery case to optimization-compass?▼

Copy the structurally closest existing case in data/seeds/site_gallery.json, rewrite it with your content, and re-evaluate every referenced ID. Then run uv run optimization-compass validate gallery to confirm the case passes validation.

Can I create new method or problem IDs when adding a Gallery case?▼

No. This workflow only uses existing canonical IDs from the generated indexes under site/public/data/. If a needed ID is missing, stop and report the gap instead of creating new IDs.

What validation command runs before submitting a Gallery case PR?▼

Run uv run optimization-compass validate gallery during editing. The PR gate is uv run optimization-compass validate tier-b, and a DCO sign-off is required on the commit.

Do I need to modify site UI code when adding a Gallery case?▼

No. The Gallery UI is generated from the data, so only data/seeds/site_gallery.json changes. Site-side code is never touched in this workflow.

What semantics must a Gallery case satisfy?▼

Per docs/adding-knowledge.md section 8, the three method sets must be non-overlapping, conditional and excluded methods need concrete reasons, map_node_id must be derivable, python_example must compile, and limitations must be stated explicitly.

Related Skills

Explore More Software Engineering Skills→
brainqub3brainqub3
13

kb-update

Write and link structured knowledge entries to the kb/ directory.

Official
Intermediate
basicmachines-cobasicmachines-co
4.0k

pr-create

Creates or updates Basic Memory pull requests and runs the Codex review loop.

Official
Intermediate
webrix-aiwebrix-ai
1

wiki-management

Audit Notion and Google Docs wikis for stale content and broken links.

Official
Intermediate
martin-hsu-testmartin-hsu-test

perspective-paul-graham

Answer questions and analyze startup ideas in Paul Graham's thinking style.

Community
Advanced