harry/skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Compress agent skills

Browse Source
This commit is contained in:
Harry Bayliss
2026-05-11 12:05:04 +01:00
parent e145482cd3
commit 7fed91d98b
20 changed files with 1009 additions and 2350 deletions
Download Patch File Download Diff File Expand all files Collapse all files

152
obsidian/SKILL.md
View File

@@ -1,138 +1,62 @@
---
name: obsidian
description: For registering personal notes and task tracking for Popdog.
description: Manage Harry's Obsidian vault notes and Popdog task tracking with the Obsidian CLI. Use when registering tasks, reading or updating Popdog notes, rolling completed work into daily roundup notes, or searching the vault.
---
# Obsidian
I have registered the `obsidian` cli. I'm using it for task tracking for Popdog.
Use the registered `obsidian` CLI for vault operations. The important working area is `Work/Popdog`, with `Work/Popdog/_Todo.md` as the outstanding-work index.
The relevant information you'll find is in Work/Popdog. There's an overall _Todo.md meta file that lists all my outstanding work.
Obsidian CLI requires the desktop app to be running; if it is not running, the first command may launch it. Target this vault explicitly if needed with `vault=<name>` as the first parameter.
Once items are verified complete they should be rolled up into the daily roundup files named YYYY-MM-DD.md.
## Popdog Task Rules
Format tasks as follows:
Use this format in `Work/Popdog/_Todo.md`:
```
```markdown
- [ ] ==**High**== Task Title
- [ ] Sub task/portion of task
- [ ] Sub task/portion of task
- [ ] **Medium** Task Title
- [ ] Sub tas/portion of task
- [ ] Sub task/portion of task
```
Note that only High priority receives highlighting == ==.
Only High priority receives `== ==` highlighting.
## Task Completion
When a task is verified complete:
When tasks are completed, mark them as such by checking the box next to the task.
- Mark it complete in `_Todo.md`.
- Roll it into the daily roundup note named `YYYY-MM-DD.md`.
- Include the PR and repo next to completed work when known.
Also roll up the completed tasks into the daily roundup files.
```markdown
- [x] Task Title (PR# - Catwalk)
- [x] Task Title (PR# - Harvester)
```
We should
## Agent Workflow
1. Read the relevant note before changing it: `obsidian read path="Work/Popdog/_Todo.md"`.
2. Use `obsidian tasks path="Work/Popdog/_Todo.md" verbose` when you need line numbers for task updates.
3. Prefer CLI mutations (`task`, `append`, `prepend`, `create`) over manual file editing when they fit.
4. Use exact `path=` values for Popdog files; use `file=` only when the name is unambiguous.
5. After updates, re-read the touched note to verify the result.
# Obsidian CLI Docs
## Common Commands
Run a command
Run an individual command without opening the TUI:
```bash
obsidian read path="Work/Popdog/_Todo.md"
obsidian tasks path="Work/Popdog/_Todo.md" todo verbose
obsidian task path="Work/Popdog/_Todo.md" line=12 done
obsidian append path="Work/Popdog/2026-05-11.md" content="- [x] Task Title (PR# - Repo)"
obsidian create path="Work/Popdog/2026-05-11.md" content="# 2026-05-11" open
obsidian search query="billing" path="Work/Popdog"
```
## Run the help command
obsidian help
Use the terminal interface
Use the TUI by entering obsidian. Subsequent commands can be entered without obsidian.
## CLI Notes
## Open the TUI, then run help
obsidian
help
The TUI supports autocomplete, command history, and reverse search. Use Ctrl+R to search your command history. See Keyboard shortcuts for all available shortcuts.
- Parameters use `key=value`; quote values with spaces.
- Flags are bare words, for example `open`, `overwrite`, `todo`, `done`, `verbose`.
- Multiline content uses `\n` and tabs use `\t`.
- Add `--copy` to copy command output to the clipboard when useful.
Files and folders
file
Show file info (default: active file).
file=<name> # file name
path=<path> # file path
Example:
path Notes/Recipe.md
name Recipe
extension md
size 1024
created 1700000000000
modified 1700001000000
files
List files in the vault.
folder=<path> # filter by folder
ext=<extension> # filter by extension
total # return file count
folder
Show folder info.
path=<path> # (required) folder path
info=files|folders|size # return specific info only
folders
List folders in the vault.
folder=<path> # filter by parent folder
total # return folder count
open
Open a file.
file=<name> # file name
path=<path> # file path
newtab # open in new tab
create
Create or overwrite a file.
name=<name> # file name
path=<path> # file path
content=<text> # initial content
template=<name> # template to use
overwrite # overwrite if file exists
open # open file after creating
newtab # open in new tab
read
Read file contents (default: active file).
file=<name> # file name
path=<path> # file path
append
Append content to a file (default: active file).
file=<name> # file name
path=<path> # file path
content=<text> # (required) content to append
inline # append without newline
prepend
Prepend content after frontmatter (default: active file).
file=<name> # file name
path=<path> # file path
content=<text> # (required) content to prepend
inline # prepend without newline
move
Move or rename a file (default: active file). This will automatically update internal links if turned on in your vault settings.
file=<name> # file name
path=<path> # file path
to=<path> # (required) destination folder or path
rename
Rename a file (default: active file). The file extension is preserved automatically if omitted from the new name. Use move to rename and move a file at the same time. This will automatically update internal links if turned on in your vault settings.
file=<name> # file name
path=<path> # file path
name=<name> # (required) new file name
delete
Delete a file (default: active file, trash by default).
file=<name> # file name
path=<path> # file path
permanent # skip trash, delete permanently
See [the CLI reference](references/cli-reference.md) for agent-oriented command coverage from the official Obsidian CLI docs.