Skip to content

feat: add craft-prompt, maya-dev, setup-matt-pocock-skills, to-tickets - #9

Merged
BramVR merged 2 commits into
mainfrom
claude/craft-prompt
Jul 22, 2026
Merged

feat: add craft-prompt, maya-dev, setup-matt-pocock-skills, to-tickets#9
BramVR merged 2 commits into
mainfrom
claude/craft-prompt

Conversation

@BramVR

@BramVR BramVR commented Jul 22, 2026

Copy link
Copy Markdown
Owner

Lands work that had been sitting uncommitted in the main checkout — four skills that existed only as untracked directories, plus the edits that accompanied them.

Why

While reconciling the local main with origin/main after the squash-merges of #6, #7, and #8, these turned up as untracked working-tree content: complete skills, in git nowhere. They were rebased onto origin/main and committed rather than left exposed to a stray clean.

Skills added

  • craft-prompt — turns rough notes, source text, or an existing prompt into a production-ready GPT-5.6 prompt through a one-question-at-a-time interview. Ships bundled offline guidance as a fallback.
  • maya-dev — launch, reconnect, diagnose, and drive the managed Maya 2024 + GG_MayaMCP session on the Windows host from macOS (mac_maya_dev, mayasessiond, SSH alias maya-win, loopback port 7002).
  • setup-matt-pocock-skills — one-time repo configuration for the engineering skills: issue tracker, triage label vocabulary, domain doc layout.
  • to-tickets — breaks a plan or conversation into tracer-bullet tickets that declare their blocking edges, published to the configured tracker.

Also: prompts/craft-prompt.md and its /prompts:craft-prompt entry in docs/slash-commands/README.md; an AGENTS.MD rule about API work running $autoreview --preset claude-opus before merge/ship and the gg_klv_push C++ branch target; and a bram-maintainer-loop-v2 bullet requiring every owner- or repository-required hosted PR review to be resolved at the exact head before merge.

Conflict resolution

The README hunk added craft-prompt to the hand-maintained Codex symlink list that #6 replaced with the generated scripts/sync-skills mirror, so that line is dropped — the mirror links the skill automatically. Verified after merge: 48 skills in both roots. The CHANGELOG entry kept its 2026-07-14 position.

Second commit

setup-matt-pocock-skills and to-tickets had unquoted description front matter; AGENTS.MD requires it quoted. Mechanical fix, no wording changed.

Reviewer notes

  • scripts/validate-skills passes at 47 skills.
  • Two of the new descriptions are considerably longer than the "short generic trigger phrase, not summary" rule in AGENTS.MDmaya-dev in particular reads as a summary and names hosts and ports. Left as authored; worth a trim if routing accuracy suffers.

BramVR added 2 commits July 22, 2026 14:53
Preserve pending work that had been sitting uncommitted in the main
checkout: four skills that existed only as untracked directories, the
/prompts:craft-prompt compatibility command, and edits to AGENTS.MD,
docs/slash-commands/README.md, and bram-maintainer-loop-v2.

Rebased onto origin/main. The README hunk added craft-prompt to the
hand-maintained Codex symlink list that scripts/sync-skills replaced, so
that line is dropped; the mirror links it automatically.
Per AGENTS.MD: quote `description` in front matter.
Copilot AI review requested due to automatic review settings July 22, 2026 12:59
@BramVR
BramVR merged commit 8640677 into main Jul 22, 2026
2 checks passed

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds four previously-untracked skills (plus supporting docs/prompts) to make prompt-crafting, Maya managed-session work, repo setup for “engineering skills”, and tracer-bullet ticket publishing available via the standard skills/ + mirror workflow.

Changes:

  • Added new skills: craft-prompt, maya-dev, setup-matt-pocock-skills, to-tickets (including agents/openai.yaml metadata and references/templates where relevant).
  • Added /prompts:craft-prompt compatibility prompt + slash-command docs and a changelog entry.
  • Updated shared agent rules (AGENTS.MD) and the maintainer loop (bram-maintainer-loop-v2) with additional landing/review discipline.

Reviewed changes

Copilot reviewed 23 out of 23 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
skills/to-tickets/SKILL.md New skill prompt for decomposing work into blocker-linked vertical-slice tickets and publishing them.
skills/to-tickets/agents/openai.yaml Agent UI metadata + disables implicit invocation for to-tickets.
skills/setup-matt-pocock-skills/SKILL.md New setup skill to scaffold per-repo issue-tracker + labels + domain-docs config.
skills/setup-matt-pocock-skills/triage-labels.md Seed template mapping canonical triage roles to tracker label strings.
skills/setup-matt-pocock-skills/issue-tracker-local.md Seed template documenting local-markdown tracker conventions under .scratch/.
skills/setup-matt-pocock-skills/issue-tracker-gitlab.md Seed template documenting GitLab issue-tracker conventions via glab.
skills/setup-matt-pocock-skills/issue-tracker-github.md Seed template documenting GitHub issue-tracker conventions via gh.
skills/setup-matt-pocock-skills/domain.md Seed template describing how skills should consume domain docs (CONTEXT/ADRs).
skills/setup-matt-pocock-skills/agents/openai.yaml Agent UI metadata + disables implicit invocation for setup skill.
skills/maya-dev/SKILL.md New operational skill for managed Maya 2024 + GG_MayaMCP session usage.
skills/maya-dev/scripts/launch.sh Helper script to check/configure and start/reconnect the managed Maya session.
skills/maya-dev/references/session-findings.md Operational findings / failure modes distilled for diagnosing Maya sessions.
skills/maya-dev/agents/openai.yaml Agent UI metadata + default routing prompt for maya-dev.
skills/craft-prompt/SKILL.md New interview-driven prompt-crafting skill with live-guidance-first + offline fallback.
skills/craft-prompt/references/gpt-5p6-guidance.md Bundled offline fallback guidance summary for GPT-5.6 prompting.
skills/craft-prompt/agents/openai.yaml Agent UI metadata + default routing prompt for craft-prompt.
skills/bram-maintainer-loop-v2/SKILL.md Adds stricter “resolve required reviews at exact head” merge discipline.
README.md Documents prompts/ as canonical sources for deprecated slash-prompt wrappers.
prompts/craft-prompt.md Adds compatibility prompt that delegates to the $craft-prompt skill.
docs/slash-commands/README.md Adds /prompts:craft-prompt to the slash-command index.
docs/slash-commands/craft-prompt.md Adds documentation for the /prompts:craft-prompt command.
CHANGELOG.md Adds 2026-07-14 entry for Craft Prompt.
AGENTS.MD Adds API-work autoreview preset guidance + gg_klv_push C++ branch rule.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread skills/maya-dev/SKILL.md
Comment on lines +2 to +3
name: maya-dev
description: "Launch, reconnect, diagnose, and use Bram's managed Maya 2024 + GG_MayaMCP development session from macOS through mac_maya_dev, mayasessiond, SSH alias maya-win, and loopback port 7002. Use for Maya modeling/rigging tasks, MayaMCP scene work, Maya startup failures, stale managed sessions, deployment selection, approved/raw scripting configuration, or verifying the Mac-to-Windows Maya tool chain."
Comment on lines +23 to +25
- `git remote -v` and `.git/config` — is this a GitHub repo? Which one?
- `AGENTS.md` and `CLAUDE.md` at the repo root — does either exist? Is there already an `## Agent skills` section in either?
- `CONTEXT.md` and `CONTEXT-MAP.md` at the repo root
Comment on lines +76 to +80
- If `CLAUDE.md` exists, edit it.
- Else if `AGENTS.md` exists, edit it.
- If neither exists, ask the user which one to create — don't pick for them.

Never create `AGENTS.md` when `CLAUDE.md` already exists (or vice versa) — always edit the one that's already there.
## Conventions

- **Create an issue**: `gh issue create --title "..." --body "..."`. Use a heredoc for multi-line bodies.
- **Read an issue**: `gh issue view <number> --comments`, filtering comments by `jq` and also fetching labels.
Comment on lines +55 to +62
python3 - "$config" <<'PY'
from pathlib import Path
import sys
import tomllib

path = Path(sys.argv[1])
with path.open("rb") as handle:
data = tomllib.load(handle)
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.

2 participants