Commit Graph
69 Commits
Author SHA1 Message Date
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
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