Commit Graph
59 Commits
Author SHA1 Message Date
steve 149dde905b Merge pull request 'refactor: restructure skills directory and add thinking-and-docs skills' (#26) from restructure into master
Reviewed-on: #26
2026-08-19 18:35:27 -04:00
gitadmin 4a4ed5cb14 refactor: restructure skills directory and add thinking-and-docs skills 2026-08-19 18:22:21 -04:00
gitadmin f65a6ec812 docs(crit): rewrite skill description and simplify framework steps 2026-08-06 20:45:47 -04:00
gitadmin 7dc4758e9a chore: remove deprecated skills and reorganize skill registry 2026-08-06 20:31:30 -04:00
gitadmin 07198e9aad feat: add openai agent metadata and lsp-code-analysis skill
Add OpenAI interface metadata to 14 skills (commit-staged,
implement-isolation, implement-isolation-tmux, project-context-pack,
setup-skills, agent-handoff, knowledge-gardener, tmux-launch-agent,
conversation-summary, crit, pkm-curation, research-vault,
youtube-video-capture, lsp-code-analysis).

Add new lsp-code-analysis skill for semantic code navigation and
refactoring via the Language Server Protocol.
2026-08-06 19:32:08 -04:00
gitadmin 8a7201b898 docs(issue-tracker): add note that labels must be created before applying 2026-07-24 00:45:32 -04:00
gitadmin f4e953186e refactor(engineering): split implement into isolation-tmux and isolation
Replace the monolithic implement-issue and implement skills with two
focused alternatives: implement-isolation (subagent + reviewer) and
implement-isolation-tmux (tmux-launch-agent for fire-and-forget).
Update the README to list the new skills.
2026-07-24 00:44:51 -04:00
gitadmin 5a6d1fccb0 chore: reorganize READMEs with sorted entries and bucket descriptions
Clean up all skill bucket READMEs — sort entries alphabetically within
user/model sections, add category descriptions to each bucket, simplify
the deprecated forge-skills doc to a bare notice, update triage label
count (5→7) in AGENTS.md, and add a Project Context Pack section.
2026-07-19 10:13:37 -04:00
gitadmin fa7619bfde docs: refresh project context and fix agent docs typos
- Update .agent/project-context.md with new paths, structure, edit boundaries
- Fix typo in issue-tracker.md: tea comments -> tea comment
- Fix jq syntax: select(.state = "open") -> select(.state == "open")
- Clean up triage-labels.md table formatting
2026-07-19 10:10:51 -04:00
gitadmin 0daa11851d refactor(tmux-launch-agent): extract tmux-open helper, add modelflag 2026-07-19 09:52:18 -04:00
gitadmin 22c3b3e45f docs(adr-wiki): rename setup-command reference to /setup-skills 2026-07-19 09:51:00 -04:00
gitadmin 102b163fc5 docs(commit-staged): remove redundant description line from SKILL.md 2026-07-15 17:19:57 -04:00
gitadmin 2a87789523 feat(engineering): add implement-isolation skill, refine implement-issue
- Add /skill:implement (implement-isolation) — ticket claim, worktree
  isolation, tdd, verify, code-review, ship loop
- Fix implement-issue: worktree path to issue-<N>-<repo-slug>,
  label semantics (remove-others), skill ref formatting, drop stale
  closing note
2026-07-15 17:18:36 -04:00
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
steve a0c5280aac Merge pull request 'issue-14-pkm-okf-alignment' (#15) from issue-14-pkm-okf-alignment into master
Reviewed-on: #15
2026-07-06 21:40:54 -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
steve b8bd012763 Merge pull request 'feat: disable model invocation for deprecated DSP dispatcher skills (#2)' (#13) from issue-2-disableorarchivedeprecatedmodel-invokedskills into master
Reviewed-on: steve/Skills#13
2026-06-27 23:36:41 -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
steve cc3c36585b Merge pull request 'fix(pkm-curation): correct contradictory and harness-specific operating rules' (#11) from issue-5-fix-contradictions-harness-guidance-pkm into master
Reviewed-on: steve/Skills#11
2026-06-27 23:18:32 -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
steve 8a230f7853 Merge pull request 'feat(implement-issue): add Section E to setup-skills for agent CLI selection' (#10) from issue-9-add-section-e-setup into master
Reviewed-on: steve/Skills#10
2026-06-27 17:07:15 -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
steve cfeb42398e Merge pull request 'feat: add implement-issue skill for dispatching child agents via worktree isolation' (#8) from issue-7-implement-issue into master
Reviewed-on: steve/Skills#8
2026-06-26 13:46:08 -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
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 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