pikers
/
piker
4
1
Fork 0
Code Issues 19 Pull Requests 14 Packages Projects Releases Wiki Activity

Add .claude/skills/* files from gap-annotator perf sesh with ma boi #69

Merged
goodboy merged 12 commits from claudy_skillz into main 2026-03-11 13:49:42 +00:00
Conversation 0 Commits 12 Files Changed 16
goodboy commented 2026-01-31 20:36:18 +00:00
Owner

All the content comes from a very good prompt-eng session i had this week using claude to optimize a newly revamped time-series gap detector i originally started realizing we needed back during the nativedb work started on GH (see historical details outline in

#62).

This inspired me to start now working toward the idealism that we can make working with all AI tools not only seamless but alot of fun.

See this follow up issue for further tracking,

https://www.pikers.dev/pikers/piker/issues/79

ToDos for this to land

  • rebase this onto main obvi but put it up right away so it can be landed quickly and ideally i can continue ongoing dev work with it mainlined.

  • the current set of files generated by claude when i asked seem to not adhere to the above docs? particularly,

  • there are various tweaks to be made in the skills file’s content themselves,

    • (e34b643e) adjustments/corrections to terms/emojis/syntaxes in the slang guide
    • read through the other technical files and extend this list as needed.
      • defer in follow up to #79

  • add a readme about how to use any existing skills/tooling and where further ideas are to be proposed/tracked in #79.

All the content comes from a very good prompt-eng session i had this week using `claude` to optimize a newly revamped time-series gap detector i originally started realizing we needed back during the `nativedb` work started on GH (see historical details outline in https://pikers.dev/pikers/piker/pulls/62). This inspired me to start **now** working toward the idealism that we can make working with all AI tools not only seamless but alot of fun. See this follow up issue for further tracking, https://www.pikers.dev/pikers/piker/issues/79 --- ## ToDos for this to land - [x] rebase this onto `main` obvi but put it up right away so it can be landed quickly and ideally i can continue ongoing dev work with it mainlined. - [x] the current set of files generated by `claude` when i asked seem to not adhere to the above docs? particularly, + https://code.claude.com/docs/en/skills#frontmatter-reference is not present? + there is no `SKILLS.md` in the subdir but [the docs say it's required?](https://code.claude.com/docs/en/skills#configure-skills) + ensuring content is organized accordingly per the [types of skill](https://code.claude.com/docs/en/skills#types-of-skill-content) section? * [x] so i think i'll start by trying to get `claude` to read its own docs and adjust XD - ALL RESOLVED in (b1588b5e1bba279e40bf44f03675fa7643ad3c64) - [x] there are various tweaks to be made in the skills file's content themselves, + [x] (e34b643e) adjustments/corrections to terms/emojis/syntaxes in the [slang guide](https://www.pikers.dev/pikers/piker/pulls/69/files#diff-03f32be9439ab086216772d2c15005df1762de44) + [ ] read through the other technical files and extend this list as needed. * defer in follow up to #79 - [x] add a readme about how to use any existing skills/tooling and where further ideas are to be proposed/tracked in #79. * done in https://www.pikers.dev/pikers/piker/commit/0134b94db07a6e084a33e12d3235401f22ba97d8
goodboy added 1 commit 2026-01-31 20:36:18 +00:00
goodboy force-pushed claudy_skillz from bc26676e59 to 7280a1452d 2026-02-22 20:34:06 +00:00 Compare
goodboy force-pushed claudy_skillz from 7280a1452d to 2166c24b48 2026-02-23 03:57:43 +00:00 Compare
goodboy force-pushed claudy_skillz from 2166c24b48 to 7ec7ff4ff9 2026-02-26 23:29:20 +00:00 Compare
goodboy force-pushed claudy_skillz from 7ec7ff4ff9 to 0f1c6455be 2026-02-27 17:50:59 +00:00 Compare
goodboy force-pushed claudy_skillz from 0f1c6455be to b1588b5e1b 2026-02-27 18:10:04 +00:00 Compare
goodboy added 2 commits 2026-03-04 20:35:21 +00:00
goodboy added 1 commit 2026-03-04 21:23:53 +00:00
b23285bbda Fix `commit-msg` skill for docs compliance 
Refactor `SKILL.md` to adhere to claude-code skills docs and
eliminate content duplication with the supporting file.

Deats,
- fix `allowed-tools` from YAML list to comma-separated string
  per frontmatter spec.
  * https://code.claude.com/docs/en/skills#frontmatter-reference
- drop ~220 lines of inlined style-guide content that duplicated
  `style-guide-reference.md`; replace with compact "Quick
  Reference" section + markdown link to the full guide.
- fix supporting file ref from backtick-code to proper markdown
  link syntax: `[style-guide-reference.md](./...)`.
- inline the file-writing instructions (timestamp + hash filename
  format) directly, replacing the now-broken `CLAUDE.md` ref.

Also,
- add missing "commit msg" footer variant to
  `style-guide-reference.md` (previously only showed "patch").
- move `.claude/CLAUDE.md` -> `style-guide-reference.md` as
  proper skill supporting file.

(this patch was generated in some part by [`claude-code`][claude-code-gh])
[claude-code-gh]: https://github.com/anthropics/claude-code
goodboy added 1 commit 2026-03-05 20:31:04 +00:00
0134b94db0 Add `ai/` integration docs w/ `/commit-msg` usage 
Deats,
- top-level `ai/README.md` w/ integration table,
  conventions, and links to PR #69 (origin) +
  issue #79 (tracking)
- `ai/claude-code/README.md` covering all 5 skills
  (summary table) and full `/commit-msg` usage guide:
  invocation, `$ARGUMENTS`, output format/files,
  frontmatter reference, dynamic context explanation

(this patch was generated in some part by [`claude-code`][claude-code-gh])
[claude-code-gh]: https://github.com/anthropics/claude-code
goodboy changed title from Add `.claude/skills/*` files from gap-annotator perf sesh with ma boi to Add `.claude/skills/*` files from gap-annotator perf sesh with ma boi 2026-03-06 14:28:58 +00:00
goodboy changed target branch from hist_backfill_fixes to main 2026-03-06 14:28:58 +00:00
goodboy added 1 commit 2026-03-10 21:58:27 +00:00
goodboy requested review from zoltan 2026-03-10 22:35:26 +00:00
goodboy requested review from guille 2026-03-10 22:35:26 +00:00
goodboy requested review from dnks 2026-03-10 22:35:27 +00:00
goodboy requested review from momo 2026-03-10 22:35:27 +00:00
goodboy merged commit ed0b89b1cd into main 2026-03-11 13:49:42 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
zoltan
guille
dnks
momo
Labels
Clear labels
No items
No Label
Milestone
Clear milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: pikers/piker#69
There is no content yet.
Delete Branch "claudy_skillz"

Deleting a branch is permanent. Although the deleted branch may exist for a short time before cleaning up, in most cases it CANNOT be undone. Continue?