Skip to content

skills I created/used - #2

Open
JorgeG94 wants to merge 2 commits into
MOM6-GPU:mainfrom
JorgeG94:add_my_skills
Open

skills I created/used#2
JorgeG94 wants to merge 2 commits into
MOM6-GPU:mainfrom
JorgeG94:add_my_skills

Conversation

@JorgeG94

Copy link
Copy Markdown

To make these I first had Claude super explore the codebase and create KNOWLEDGE.md plus the other little files that are inside the repo. Based on that I distilled the information down and created three skills: gpu-data-residency which knows about enter/exit data and maps back where and what is being allocated/copied; mom6-gpu-architect which is a planner skills, looks at a module you point it at and uses the knowledge and stuff to propose a porting plan, suggests if refactor is needed first; mom6-gpu-programmer which uses both skills and is an end-to-end skill that will design, propose (ask you about it), and go ahead and implement. It knows to keep ocean.stats for bitwise repro. It WILL commit once it has proven something is bitwise repro, if it can't get bitwise reproducibility it will stop and wait for you.

I am still reading through all the knowledge docs it created but this skill produced this PR

JorgeG94 and others added 2 commits July 16, 2026 08:57
Purely additive: nothing in the existing skill (SKILL.md, references/,
README.md) is moved, renamed or edited.

skills/
  mom6-gpu-architect    map a routine's shape and call graph, then decide
                        refactor-first vs port-in-place. The triage input is
                        the loop-interior call list, not the line count -- a
                        callee at loop depth > 0 must become device-callable or
                        be hoisted first. Ships routine-map.sh and callees.sh.
  gpu-data-residency    where enter/exit data belongs, map(to:) vs map(alloc:),
                        and where update from/to is needed for host-only
                        consumers. Engine is a host/device coherence state
                        machine walked in execution order. Ships
                        residency-scan.sh.
  mom6-gpu-programmer   the driver: sequences the other skills and owns the
                        stop-gates between phases.

knowledge/
  KNOWLEDGE.md and the 15 deep-dive docs. The skills are not self-contained --
  they make 59 references into these -- so the knowledge travels with them.

knowledge/README.md records provenance: the file:line anchors are only valid
against dev/gpu @ c82e1254a, and there is no MOM6 source in this repo to
contradict a stale one. It also flags that KNOWLEDGE.md's §8a/§8b confidence
markers (verified from source / needs a run / open maintainer decision) are
load-bearing and should not be flattened to assertion.

These skills sit alongside the existing one rather than replacing it: that one
covers how to write a correct MOM6 GPU loop; these cover what to port, in what
order, and where the data lives. A follow-up should reconcile the overlaps and
agree a multi-skill layout -- both are better raised with the author than done
unilaterally.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant