Commit Graph
79 Commits
Author SHA1 Message Date
gitadmin 01c488157d docs: rewrite repo indexes and context pack for skills/ layout
Replace the stale common/ structure docs with the current skills/ bucket
layout. Root and bucket READMEs now index every SKILL.md by invocation
type, AGENTS.md lists the ten actual buckets, and the project context
pack is condensed to purpose, structure, conventions, and validation.
2026-10-06 14:00:45 -04:00
gitadmin d956e513a4 chore(skills): move audit skills to engineering, drop dual-review 2026-10-06 13:44:55 -04:00
steve 4d39989424 Merge pull request 'feat: orchestrate plans with Herdr' (#31) from issue-30-orchestrate-plans-from-context-to-merged-prs-with-herdr into master
Reviewed-on: #31
2026-10-06 13:33:53 -04:00
gitadmin 781aa7dc94 fix: ignore persisted orchestration state 2026-10-06 12:50:46 -04:00
gitadmin eacd08426f fix: correct skill metadata descriptions 2026-10-06 12:49:03 -04:00
gitadmin a8b7227500 feat(pstack): add poteto skill stack (how/why/reflect/interrogate/reviews)
Import 12 skills from poteto under skills/pstack: bugfix-regression-test,
code-quality-review, dual-review, fix-merge-conflicts, how, interrogate,
reflect, security-audit, unslop, why, with progressive-disclosure
references. Credit poteto in README.
2026-10-06 12:48:40 -04:00
gitadmin 7c62958c31 feat(pr): add pr skill for writing PR bodies
Adds a user-invoked pr skill with a Summary/Evidence/Merge Danger
template, visual-format guidance adapted from Dex Horthy's show-me
skill (attribution in CREDITS.md), and an openai agent interface.
2026-10-06 12:47:56 -04:00
gitadmin 8be5a50b1e feat(implement-spec): add skill to implement spec tickets via subagent task graph 2026-10-06 12:47:32 -04:00
gitadmin 31d225e5b9 docs(readme): credit originators of skills in repo 2026-10-06 12:46:52 -04:00
gitadmin 18ef02a331 feat: add orchestrate-herdr skill and dual-review; make to-spec/to-tickets agent-invocable
Add an explicitly invoked Pi orchestration skill that drives a plan from the
current conversation or an @file through a published spec, linked dependency-aware
tickets, and one-at-a-time isolated implementation to a merged PR, using Herdr
and Pi agents with no Bun CLI or orchestration runtime.

- orchestrate-herdr (SKILL.md + dispatcher/run-loop/state references): worker-node
  selection and Herdr discovery/validation, plan-and-publish, one-at-a-time task
  loop (claim, isolate, implement, verify, four-axis review, scoped fix rounds max
  three, transient retries max two, reconcile uncertain side effects, escalate),
  PR/merge/close gates, authoritative worker-node state, cross-system recovery,
  and owned-only cleanup that preserves dirty worktrees and retained state.
- dual-review: self-contained correctness/security + maintainability review axis
  (four-axis review with code-review).
- to-spec and to-tickets: drop disable-model-invocation so the orchestration
  workflow can invoke them.
- READMEs: list the two new skills.
2026-10-06 12:45:12 -04:00
gitadmin 53da2f7094 docs(setup-skills): add Gitea forge write safety rules
tea --description does not read stdin via @-, so a piped heredoc silently
creates an issue whose body is the literal "@-". Document the command-
substitution form, a post-create body check, and inspecting tea --help
before relying on CLI syntax.
2026-09-25 13:16:09 -04:00
gitadmin dab262ac23 feat: add arch-maintenance and arch-troubleshooting skills 2026-09-22 17:52:48 -04:00
gitadmin b9567c5e39 refactor: rename dev-workflow skill to implementation-orchestrator
The name dev-workflow described a category, not what the skill does. It
orchestrates implementation of already-planned tickets, so the new name
says that. Skill dir, docs page, name field and openai display name are
updated to match; validate-skill.sh moves with the dir and its paths are
fixed for the new depth and engineering/ layout.
2026-08-30 13:40:27 -04:00
gitadmin 3be0f20eef docs(dev-workflow): state ticket id/url is optional up front
Move the no-argument behaviour into the description and lead the body with
it so the trigger condition is visible before the skill is invoked.
2026-08-30 12:44:20 -04:00
gitadmin c97603c937 feat: add dev-workflow and forge-cli skills
Add two engineering skills for implementing tracker tickets end to end:

- dev-workflow: selects workflow:ready-for-agent tickets, runs them in
  isolated worktrees, opens one PR/MR per ticket, reviews, merges, and
  cleans up.
- forge-cli: detects the forge from origin and wraps gh, glab, and tea
  for Gitea/Forgejo, GitHub, and GitLab.

Docs cover install, prerequisites, ticket labels, and per-forge CLI usage.
2026-08-30 12:29:54 -04:00
gitadmin eb4a13166e docs(wayfinder): clarify bare number means forge issue number 2026-08-28 18:12:03 -04:00
gitadmin 77cc1c7c8b removed duplicate teach skill 2026-08-28 14:55:02 -04:00
gitadmin 103bc141dc feat: add recipe-diagrams, worktrees, and misc skills 2026-08-28 13:48:19 -04:00
gitadmin a9669c28ec docs: restructure skill catalog and standardize setup-skills references
Reorganize README.md with category sections (engineering, pkm, etc.)
for both user-invoked and model-invoked skills. Add new subcategory
READMEs for skill-authoring and thinking-and-docs. Replace
/setup-matt-pocock-skills references with setup-skills across all SKILLs.
2026-08-27 20:32:28 -04:00
gitadmin 0a4bac7adf added matt pocock skills 2026-08-27 20:14:59 -04:00
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