Skip to content

skills: dedup overlapping .claude/skills#611

Merged
coderfeli merged 1 commit into
mainfrom
worktree-skills-dedup
Jun 4, 2026
Merged

skills: dedup overlapping .claude/skills#611
coderfeli merged 1 commit into
mainfrom
worktree-skills-dedup

Conversation

@fsx950223
Copy link
Copy Markdown
Contributor

Summary

Removes duplication among the .claude/skills set (17 → 14 skills). No behavior change to the codebase; this only touches skill docs.

1. Merge check-python-styleformat-code

format-code was already the superset (Python + C++) and already drove scripts/check_python_style.sh. It now also covers the check-only path:

  • New "Check only (reproduce the CI gate without editing files)" section: check_python_style.sh without --fix, --install, and --include-local diff-scope semantics.
  • Folded in the "PR CI flags unrelated files = branch behind main" tip.
  • description picks up the CI-check triggers ("Check Python Code Style" job, before pushing, CI style failure).
  • Deleted check-python-style/.

2. Clear division: flydsl-kernel-authoring (reference) vs flydsl-tile-programming (wizard)

  • Added the missing YAML frontmatter to flydsl-tile-programming (it previously had none, so it wasn't properly discoverable), marking it the guided step-by-step wizard.
  • Added a Scope note to each skill: authoring = reference (API/layout algebra, per-op tables, env vars, troubleshooting); tile-programming = procedure (classify → skeleton → compute → control flow → test).
  • Redirected the duplicated MFMA reference and Debug Common Errors tables from the wizard to authoring (§6 / §10), and pointed deep debugging at debug-flydsl-kernel.

3. Delete redundant refactor skills

  • Deleted flydsl-internal-types-cleanup and port-to-layout-api (their guidance is already covered by flydsl-kernel-authoring; no other files referenced them).

Verification

  • No dangling references to the removed/merged skill names.
  • Frontmatter of all three modified skills parses (name/description present).
  • prefetch-data-load's reference to flydsl-kernel-authoring remains valid.

🤖 Generated with Claude Code

- Merge check-python-style into format-code: format-code gains a
  "Check only" section (reproduce the CI gate without editing), the
  --include-local diff-scope note, and the behind-main tip; description
  picks up the CI-check triggers. Delete check-python-style.
- Clarify division between flydsl-kernel-authoring (reference) and
  flydsl-tile-programming (guided wizard): add missing frontmatter to
  tile-programming, add a Scope note to each, and redirect the
  duplicated MFMA and debug-errors tables from the wizard to the
  reference.
- Delete flydsl-internal-types-cleanup and port-to-layout-api.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings June 2, 2026 08:20
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR deduplicates and reorganizes the .claude/skills documentation set by merging overlapping skills, clarifying scope boundaries between kernel-authoring reference vs tile-programming wizard, and deleting redundant skills.

Changes:

  • Merged check-python-style guidance into format-code and added a check-only section for reproducing CI locally.
  • Added missing YAML frontmatter to flydsl-tile-programming and removed duplicated troubleshooting/MFMA reference tables in favor of linking to flydsl-kernel-authoring.
  • Deleted redundant/refactored skills (check-python-style, port-to-layout-api, flydsl-internal-types-cleanup).

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
.claude/skills/format-code/SKILL.md Expands skill scope to include check-only CI reproduction instructions and updates description accordingly.
.claude/skills/flydsl-tile-programming/SKILL.md Adds YAML frontmatter + explicit scope note; replaces duplicated reference tables with links to the reference skill(s).
.claude/skills/flydsl-kernel-authoring/SKILL.md Adds an explicit “reference vs wizard vs debugging” scope note near the top.
.claude/skills/check-python-style/SKILL.md Deleted after being merged into format-code.
.claude/skills/port-to-layout-api/SKILL.md Deleted as redundant with broader authoring/reference guidance.
.claude/skills/flydsl-internal-types-cleanup/SKILL.md Deleted as redundant with broader authoring/reference guidance.

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

Comment thread .claude/skills/format-code/SKILL.md
Comment thread .claude/skills/format-code/SKILL.md
@coderfeli coderfeli merged commit 03f0bf6 into main Jun 4, 2026
14 checks passed
@coderfeli coderfeli deleted the worktree-skills-dedup branch June 4, 2026 09:13
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.

3 participants