Skip to content

chore: move agent skills to .claude/skills, drop Copilot, add workflow skills - #329

Merged
timdegroot1996 merged 2 commits into
mainfrom
improving-skills
Sep 16, 2026
Merged

timdegroot1996 merged 2 commits into
mainfrom
improving-skills

Conversation

@timdegroot1996

@timdegroot1996 timdegroot1996 commented Sep 16, 2026

Copy link
Copy Markdown
Collaborator

Why

Claude Code only auto-discovers project skills under .claude/skills/<name>/SKILL.md. The flat .github/skills/*.md files were never listed by the tool and depended on the agent choosing to read them from a table in CLAUDE.md — which is how the "robot tests run in Docker" rule got missed while working #327/#328.

What

  • Skills relocated and consolidated: 19 flat files → 13 skills, each with name + trigger-style description frontmatter.
    • Merged: testing (robot + python + js references, Docker hard rule, CI diagnosis via gh run download), dev-workflow, coding-standards.
    • project-architecture and conventions-and-gotchas folded into CLAUDE.md.
  • New skills: gh-issue (fetch → branch → root cause → fix → regression test in Docker → /code-review → report; commit only on explicit approval), add-cli-argument, plus an add-a-graph checklist in dashboard-graphs.
  • Stale content fixed: non-existent scripts\unittests.bat/jstests.bat, wrong test helper paths, filter pipeline stages (custom filters, suite path, tagMode vs useOrTags), JS unit-test coverage table, docs page map, example.sh, js-bundling module tree, and the camelCase-vs-snake_case contradiction (functions snake_case, variables camelCase, per the actual code).
  • CLAUDE.md rewritten: skills table, robot tests Docker-only with the reason, hard rules, gotchas. All Copilot references removed (.github/copilot-instructions.md, .github/skills/ deleted).
  • Docker wrappers: scripts/docker/run-in-container.sh allocates a TTY only when stdin is one; .bat skips -t under CLAUDECODE/CI. Verified from a non-TTY shell.
  • .gitignore: .claude/settings.local.json.

Not included

  • A PreToolUse hook enforcing the Docker rule (discussed, deferred).
  • CONTRIBUTING.md still documents local robot runs for human contributors.

🤖 Generated with Claude Code

timdegroot1996 and others added 2 commits September 16, 2026 02:36
Claude Code only auto-discovers skills under .claude/skills/<name>/SKILL.md;
the flat .github/skills/*.md files were never listed and depended on the
agent choosing to read them from a table. That is how the Docker-only rule
for robot tests got missed in #328.

- 19 flat files -> 14 skills with name/description frontmatter written as
  triggers. Merged: testing (robot + python + js, with Docker rule and CI
  diagnosis), dev-workflow, coding-standards. Folded architecture and
  gotchas into CLAUDE.md.
- New skills: gh-issue (issue -> branch -> fix -> test -> review, commit
  gated on approval), add-db-column, add-cli-argument; add-graph checklist
  in dashboard-graphs.
- Fixed stale content: script names (unittests/jstests), test paths,
  filter pipeline stages and tagMode, JS test coverage table, docs page
  map, example.sh, module tree, camelCase/snake_case contradiction.
- CLAUDE.md: robot tests Docker-only with the reason (suites run the
  installed CLI, not the working tree); no Copilot references.
- scripts/docker/run-in-container.{sh,bat}: only allocate a TTY when one
  exists so the wrappers work from CI and agent shells.
- .gitignore: .claude/settings.local.json.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@timdegroot1996
timdegroot1996 merged commit 3d65504 into main Sep 16, 2026
5 of 6 checks passed
@timdegroot1996
timdegroot1996 deleted the improving-skills branch September 16, 2026 01:27
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