pin-query
SkillDev toolsUse when looking up pins by type, tags, or source. Drives lib/pins/query.ts to retrieve matching pin entries from the knowledge graph. Supersedes the legacy manual ls+frontmatter procedure.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the pin-query skill
What this skill tells your AI
The instructions your AI receives, as published by toongri/oh-my-toong-playground in skills/pin-query/SKILL.md and read by ahel’s review.
Retrieve pins from the knowledge graph by calling query(pinsDir, criteria) from lib/pins/query.ts.
Retrieval model
query calls buildIndex() on every invocation, scanning pinsDir in-memory. There is no index.json cache; every call performs a full directory scan and produces results directly.
The full entity set is always covered, including pins with no outgoing relations. Orphan pins remain findable by type, tags, or source — relation traversal is not required.
Invocation
Run the bundled script from the deployed skill directory:
bun "${CLAUDE_SKILL_DIR}/scripts/query.ts" [--type <type>] [--tags <tag1,tag2>] [--source <source>]
--tags accepts a comma-separated list; all tags must match (AND semantics). Omit any flag to leave that field unrestricted. The script resolves the manifest automatically — if no manifest exists it prints the absent message and exits 0.
Presenting results
Return matched slugs (id), source_url from the frontmatter, and a one-line summary to the caller. Report "no match" on an empty result set. Do not re-traverse the graph; the returned Frontmatter already carries relations if the caller needs to follow links.
Signals
- GitHub stars
- 25
- Forks
- 1
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
pin-query- Source
- github.com/toongri/oh-my-toong-playground