Commit Graph
14 Commits
Author SHA1 Message Date
gitadmin cc10b66365 feat(pkm): add youtube-video-capture skill
Captures subtitles from a YouTube video via yt-dlp, produces a prose
summary with key takeaways, and saves both as OKF-conformant notes
into the Video/ bundle in the Obsidian vault.
2026-07-10 09:52:14 -04:00
gitadmin c68f6b4267 docs: reorganize skill catalog structure and update descriptions
- Restructure skill listings across all README files
- Add new skills: agent-handoff, commit, tmux-launch-agent, lsp-code-analysis
- Move knowledge-gardener and agent-handoff to in-progress status
- Reassign skills between user-invoked and model-invoked categories
- Update descriptions to include OKF v0.1 conventions for conversation-summary and research-vault
- Remove empty productivity skill bucket
- Consolidate deprecated skill sections
2026-07-09 12:41:39 -04:00
gitadmin de4f6f137b phase4-7: rewrite PKM skills for OKF v0.1 alignment
Phase 4: Rewrite research-vault skill
- Packet becomes OKF bundle with index.md (no frontmatter) and log.md
- All packet pages get proper type frontmatter
- Atomic note template uses merged OKF + vault schema
- Links use markdown [...](...) not wikilinks
- Updated research-packet-template.md reference

Phase 5: Rewrite pkm-curation skill
- Frontmatter normalization adds type field using classification heuristics
- Links use markdown [...](...) not wikilinks
- Bundle awareness added (update index.md, log.md)
- Updated agent-integration.md for OKF conventions

Phase 6: Rewrite conversation-summary skill
- AI Conversation Summaries/ bundle awareness (update index.md, log.md)
- Report and transcript notes get merged frontmatter with proper type
- Links use markdown [...](...) not wikilinks

Phase 7: Review crit skill
- No vault I/O changes needed — pure brainstorming framework
2026-07-06 21:34:55 -04:00
gitadmin 41d1d48025 phase1: update vault-conventions.md with OKF v0.1 spec alignment
- Merged OKF + vault frontmatter schema
- Standard markdown links (not wikilinks)
- Bundle definition with index.md/log.md conventions
- Fixed type vocabulary (18 types)
- Bundle map for all vault directories
- Updated curation heuristics for bundle awareness
- Added OKF core principles
2026-07-06 21:26:46 -04:00
gitadmin c92ee69440 refactor: extract tmux-launch-agent from implement-issue/setup-skills, overhaul PKM skills
- New common/misc/tmux-launch-agent skill with detect-agent script
  and agents-seed.md (moved from engineering/setup-skills)
- implement-issue simplified: delegates agent dispatch to
  tmux-launch-agent instead of inlining it
- setup-skills stripped of Section E (agent CLI config)
- New in-progress/agent-handoff skill using tmux-launch-agent
- PKM skills simplified: conversation-summary and pkm-curation
  rewritten with leaner process, crit streamlined
- knowledge-gardener removed (moved to common/in-progress/)
- All READMEs updated to match
2026-07-06 11:29:16 -04:00
gitadmin 74572c1b78 fix: remove obsolete contradiction test for pkm-curation
The skill no longer contains the contradictions this test was checking for
(prefer-reorganization phrasing, hardcoded cat requirement). Test file
served its purpose during the fix and is no longer needed.
2026-06-27 23:12:25 -04:00
gitadmin c7ed24ea51 fix(pkm-curation): correct contradictory and harness-specific operating rules
- Change 'Prefer reorganization over curation' to 'Prefer curation over reorganization'
- Remove 'cat' mandate, replaced with tool-neutral 'read completely' guidance
- Consolidate duplicate file-read requirement into single clear rule

Fixes (#5)
2026-06-27 22:39:45 -04:00
gitadmin fa29b93a02 feat(pkm-curation): enable model invocation for pkm-curation skill 2026-06-26 14:19:15 -04:00
gitadmin cd40daec54 Fix README links, add missing skills, correct invocation classification
- Fixed 3 broken links in root and common READMEs (pkm-curation,
  forge-interaction, forge-preferences were pointing to wrong buckets)
- Moved project-context-pack from model-invoked to user-invoked
  (matches its disable-model-invocation: true flag)
- Added 8 missing user-invoked and 6 missing model-invoked skills
  to root and common READMEs
- Added all 9 engineering skills to engineering README
  (was missing codebase-design, domain-modeling, resolving-merge-conflicts,
  tdd, grill-with-docs, improve-codebase-architecture, setup-skills,
  to-issues, to-prd, triage)
- Added pkm-curation to pkm README
- Updated personal README to note both skills moved elsewhere
- Added all forge skills to deprecated README
- Added .gitignore for docs/adr/
- Added docs/agents/ reference files
- Added project context cache
2026-06-25 12:26:32 -04:00
gitadmin 371697375a refactor(pkm-curation): move skill from common/personal to common/pkm directory 2026-06-25 12:04:08 -04:00
gitadmin 66c7308f64 refactor: replace hardcoded vault paths with generic placeholders 2026-06-24 22:32:30 -04:00
steveandgitadmin ec931d9552 feat(crit): rewrite skill to implement CRIT framework (#6)
This PR rewrites the `crit` skill from a general description into a concrete CRIT (Context-Request-Input-Tone) workflow.

## Changes
- Transformed abstract skill description into structured 5-step workflow
- Added clear completion criteria for each step
- Implemented quality guardrails and trigger hints
- Followed established patterns from other skills (conversation-summary, knowledge-gardener)

## Impact
- Makes the crit skill more actionable and predictable
- Provides systematic brainstorming and idea evaluation
- Improves user experience with structured guidance

## Files Changed
- common/pkm/crit/SKILL.md

Co-authored-by: Steve Beaulac <steve@beaulac.me>
Reviewed-on: steve/Skills#6
2026-06-24 00:21:34 -04:00
gitadmin 91e643553e feat(pkm): add compiled wiki layer, packet promotion, and retrieval checks to research skills
- Add compiled wiki maintenance, retrieval lint, and packet promotion
  steps to knowledge-gardener skill
- Restructure research-vault workflow with source ingest, answer filing,
  and pre-completion lint pass
- Add Log.md for tracking ingest, queries, and corrections
- Enhance Claims template with provenance, supports/contradicts, and
  confidence tracking
- Add Compiled Pages table and Raw Source Rules to packet template
- Enhance atomic notes with frontmatter, promotion status, and
  structured links
- Distinguish source claims, synthesis, user opinions, and open
  questions throughout

This implements a Karpathy-style compiled wiki approach where raw
sources stay immutable, packet notes are the maintained synthesis
layer, and reusable notes can be promoted to the main vault.
2026-06-22 23:06:03 -04:00
gitadmin af96c9e331 docs: reorganize skills into pkm category and add crit skill
- Create new `pkm` directory for Personal Knowledge Management skills
- Move conversation-summary, knowledge-gardener, and research-vault from `personal` to `pkm`
- Add new crit skill for brainstorming with the CRIT framework
- Update skill descriptions for clarity and consistency
- Add audio-product-dsp, grilling, and research-engineering to model-invoked listings
- Update skill paths across README files to reflect new directory structure
2026-06-22 22:20:08 -04:00