Commit Graph
40 Commits
Author SHA1 Message Date
gitadmin 9b4c6952c5 docs(setup-skills): refine setup flow and issue tracker guidance 2026-07-14 11:52:20 -04:00
gitadmin d8be029afb refactor: rename commit skill to commit-staged
The folder name now matches the  field in the SKILL.md frontmatter.
Updated links in the root, common/, and engineering/ READMEs.
2026-07-10 11:25:57 -04:00
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 36536e0e11 feat: add commit skill 2026-07-10 09:16:06 -04:00
gitadmin e16ca1114a feat(common/in-progress): add knowledge-gardener skill and index README
- Add knowledge-gardener skill for Obsidian vault gardening.

- Add README index for in-progress skills.

- Broaden artifact references in agent-handoff skill.
2026-07-10 09:09:30 -04:00
gitadmin 8829e27004 docs(skills): add forge-gitea, forge-github, and misc skill docs
Add deprecated forge-gitea and forge-github skill entries to the main
README, and create a new misc category for rarely used skills like
tmux-launch-agent.
2026-07-10 08:57:44 -04:00
gitadmin 1b5398afdc docs(setup-skills): add wayfinder operations and update skill references
- Add wayfinding operations section to all issue tracker backends (GitHub, GitLab, Gitea)
- Update skill names from `to-issues`/`to-prd` to `to-tickets`/`to-spec`
- Fix Gitea CLI reference from `gitea` to `tea`
- Fix ADR path from `adr` to `docs/adr`
- Fix various typos and whitespace issues in Gitea tracker docs
2026-07-09 12:51:58 -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 1676528fad chore(skills): remove agent-cli configuration and fix minor typos
Remove `docs/agents/agent-cli.md` and all references to it from
`setup-skills/SKILL.md` (contents list, docs files list, and the
Agent CLI block template). Fix typo "languagee" → "language" in
`setup-skills/SKILL.md` and "labels" → "label" in
`implement-issue/SKILL.md`.
2026-07-06 15:09:56 -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 1614a0d469 removed all mattpocock skills. will use alternative repo 2026-07-05 17:33:49 -04:00
gitadmin 88d3f3e81e feat: disable model invocation for deprecated DSP dispatcher skills (#2) 2026-06-27 23:30:10 -04:00
gitadmin a6b00a7f11 refactor(implement-issue): replace @{prompt} placeholder with {prompt} and remove deprecated --agent flag
Replace the `@{prompt}` placeholder with `{prompt}` across all skill docs and
agent-cli configs, remove the deprecated `--agent` flag from the invocation
syntax, delete the now-obsolete agent-cli test file, clarify that only one
triage label should be active at a time, and defer prompt-file cleanup to the
OS/child instead of removing it immediately after tmux launch.
2026-06-27 23:18:49 -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 fe364b3c63 AGENTS.md | 4 ++++
docs/agents/agent-cli.md | 4 ++--
 2 files changed, 6 insertions(+), 2 deletions(-)
2026-06-27 17:44:26 -04:00
gitadmin 032a842e82 Remove tea CLI dependency from implement-issue skill
Streamline the skill by removing tea-specific command examples. The
checks (issue exists, labels, blockers) still need to happen but
the exact commands are now at the discretion of the agent.

Also update agents-seed.md to fix arg configurations and add missing
notes about stdin piping.
2026-06-27 17:05:57 -04:00
gitadmin f9611e1343 feat(implement-issue): add Section E to setup-skills for agent CLI selection
- Add agents-seed.md as source of truth for supported agents
- Add Section E to setup-skills to present agent menu and validate binary on PATH
- Refactor implement-issue to read docs/agents/agent-cli.md instead of hardcoded table
- Remove detect-agent-linux.sh and detect-agent-macos.sh detection scripts
- Add mise/$SHELL -c runtime detection for agent dispatch
- Add invocation-time binary validation with clear error message
- Add test file documenting expected tmux command composition

Closes #9
2026-06-27 16:26:17 -04:00
gitadmin fa29b93a02 feat(pkm-curation): enable model invocation for pkm-curation skill 2026-06-26 14:19:15 -04:00
gitadmin 8af5a20da5 docs(triage): add needs-review and in-progress labels
- Replace `in-review` with `needs-review` in implement-issue workflow
- Document `needs-review` and `in-progress` labels in triage labels table
- Sync label definitions across setup-skills and docs/agents
2026-06-26 14:00:55 -04:00
gitadmin dc9293c7be feat(implement-issue): make child agent dispatch agent-agnostic
- Add formal arg syntax: --agent, --base, --force
- Add process-tree detection scripts (Linux / macOS) to auto-detect parent agent
- Add dispatch table supporting pi, opencode, goose, codex, claude + unknown fallback
- Write child prompt to temp file instead of inline escaping
- Name tmux windows for discoverability
- Add new pre-flight checks: tmux session, agent detection, binary on PATH
2026-06-26 13:42:56 -04:00
gitadmin e6e322e542 feat: add implement-issue skill for dispatching child agents via worktree isolation (#7) 2026-06-26 11:39:21 -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 ff41e7965a refactor(forge): split forge-interaction into specialized GitHub and Gitea skills
Break the monolithic forge-interaction skill into focused, single-responsibility
skills for better predictability and maintainability:

- Add forge-github skill for GitHub-specific interactions using `gh` CLI
- Add forge-gitea skill for Gitea-specific interactions using `tea` CLI
- Convert forge-interaction into a router that delegates to specialized skills
- Add forge-router skill with model invocation disabled for guidance only
- Move all forge-related skills to common/deprecated directory

Each specialized skill now contains its own complete decision tree, CLI usage
patterns, and authentication checks for its respective forge platform.
2026-06-25 12:06:08 -04:00
gitadmin fbca2ada7e docs(project-context-pack): clarify procedure, tighten wording, add disable-model-invocation
- Rewrite step names and descriptions for clarity and conciseness
- Reorder navigation discipline and expand sensitive-file examples
- Add `disable-model-invocation: true` frontmatter flag
- Remove unused `date -Iseconds` command pattern
2026-06-25 12:05:01 -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 68f9b4691e feat(skills): add engineering skill definitions under common/engineering/ all from @mattpocock
Add 10 skill definitions covering codebase design, domain modeling,
test-driven development, triage, and development workflows:

- codebase-design: vocabulary and patterns for designing deep modules
- domain-modeling: build and sharpen project domain models
- grill-with-docs: interview-based design refinement with documentation
- improve-codebase-architecture: scan and report on deepening opportunities
- resolving-merge-conflicts: structured approach to merge/rebase conflicts
- setup-skills: per-repo configuration for engineering skills
- tdd: test-driven development workflow with vertical slices
- to-issues: break plans into tracer-bullet vertical slice issues
- to-prd: synthesize conversations into PRDs
- triage: state machine for issue/PR triage roles

Includes supporting files for ADR formats, issue tracker integrations
(GitHub, GitLab, Gitea), triage labels, and agent brief templates.
2026-06-25 12:01:55 -04:00
gitadmin 66c7308f64 refactor: replace hardcoded vault paths with generic placeholders 2026-06-24 22:32:30 -04:00
gitadmin 510d4be99c docs(forge-preferences): replace open questions with derived preferences and add conventions
- Replace hardcoded open questions with runtime-derived preferences for
  forge remote, CLI, and host/username detection
- Add issue label mapping reference to triage-labels.md
- Add PR title/body conventions following Conventional Commits
- Add release tagging conventions with semver format
2026-06-23 23:58:12 -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 1a03d0a0ff feat(skills): add project-context-pack skill
Add a new engineering skill that creates or refreshes a bounded project
memory file to serve as a navigation map for repository exploration.

The skill follows a disciplined search procedure that:
- Uses fd/rg for inventory before broad file reads
- Classifies project type with evidence citations
- Reads selectively with per-file content caps
- Indexes via tree-sitter/LSP/rg before browsing source
- Caches results in .agent/project-context.md

References the skill in README.md, common/README.md, and
common/engineering/README.md.
2026-06-22 22:20:58 -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
gitadmin e7fcc51e86 docs(skills): reorganize skill catalog into category READMEs
- Add deprecated skills README with audio-product-dsp and research-engineering
- Add productivity skills README with grill-me, handoff, writing-great-skills, and grilling
- Move forge-preferences from user-invoked to model-invoked in personal skills
2026-06-22 15:08:34 -04:00
gitadmin 8b16e97052 feat: add research-vault skill and reorganize skill paths
- Add research-vault skill with conversational research workflow and Obsidian packet output
- Add research packet template with Index, Sources, Synthesis, Claims, Questions, Conversation, and Glossaries
- Add personal/README.md listing personal skills
- Reorganize common/README.md paths into personal/ and productivity/ subdirectories
2026-06-22 15:04:14 -04:00
gitadmin 503193793f fix: correct typo in conversation-summary SKILL.md frontmatter key
The YAML frontmatter key `name-:` was corrected to `name:` to ensure proper parsing of the skill metadata.
2026-06-22 14:25:12 -04:00
gitadmin 9b5e82f395 chore(skills): add deprecated audio and DSP dispatcher skills
Archive two dispatcher skills to the deprecated directory:
- audio-production-dispatcher: routes audio product DSP engineering
  requests across voice, playback, spatial, ANC, embedded, and
  validation specialist paths
- dsp-research-dispatcher: routes DSP hardware/software
  research-engineering requests to appropriate specialist workflows
2026-06-22 14:24:23 -04:00
gitadmin cc39d45a96 feat(skills): add personal and productivity agent skills
Add new skill definitions organized by category:

Personal:
- conversation-summary: summarize AI conversations into Obsidian notes
- knowledge-gardener: vault-aware semantic search and Zettelkasten workflows

Productivity:
- grill-me: alias for running a grilling session
- grilling: relentless interview to stress-test plans
- handoff: compact conversation into handoff document for agent continuity
- writing-great-skills: reference guide for skill authoring best practices
- glossary: domain model for skill-building terminology
2026-06-22 14:20:28 -04:00
gitadmin 041be56757 feat: initialize agent skills repository with three starter skills
Add project structure documentation (AGENTS.md) and initial README files
that organize skills by bucket and invocation type (user-invoked vs
model-invoked).

Introduce three skills:
- forge-interaction: GitHub/Gitea CLI automation for issues, PRs, releases
- forge-preferences: personal forge conventions (companion to forge-interaction)
- pkm-curation: Obsidian vault curation and note management

Include reference docs for vault conventions, agent integration, and the
invocation model that separates user-only from model-reachable skills.
2026-06-22 13:15:36 -04:00