hermes-agent/skills
Teknium ad7aad251c
feat(skills/linear): add Documents support + Python helper script (#20752)
* feat(skills/linear): add Documents support + Python helper script

The bundled Linear skill (PR #1230) covered issues, projects, teams, and
workflow states via curl. It had no coverage for Linear's Documents API,
so fetching an RFC/doc from a linear.app URL required hand-writing
GraphQL against an underdocumented schema.

Adds:
- Documents section in SKILL.md explaining slugId extraction from URLs,
  the contentState (markdown) vs contentState (ProseMirror) split, and
  four canonical curl examples (fetch by slugId, fetch by UUID, list
  recent, title-search).
- scripts/linear_api.py — stdlib-only Python CLI wrapping the most
  common operations (whoami, list-teams, list/get/search/create/update
  issues, add-comment, update-status, list/get/search documents, raw
  GraphQL passthrough). Zero deps, reads LINEAR_API_KEY from env.

Auth header quirk (personal key takes bare $LINEAR_API_KEY, no Bearer
prefix) is already documented in the skill.

Found during RFC review: the existing skill's lack of document support
forced falling back to the browser (which hit Linear's login wall).
Also fixes a schema gotcha — the Document field is `contentState`, not
`contentData` (which returns 400).

Tested end-to-end against the production API:
  python3 linear_api.py whoami
  python3 linear_api.py get-document 38359beef67c
Both return expected payloads.

* fix(skills/linear): point LINEAR_API_KEY setup to the correct page

The org-level Settings > API page (/settings/api) only shows OAuth apps
and workspace-member keys. Personal API keys live under Account,
Security, access (/settings/account/security). Update both the setup
link in config.py (shown during hermes setup) and the setup step in
SKILL.md so users land on the page that can create a personal key.
2026-05-06 08:27:21 -07:00
..
apple
autonomous-ai-agents docs(codex): clarify OAuth auth prerequisite 2026-05-05 13:53:55 -07:00
creative fix(skills/comfyui): correct hallucinated node names and registry slugs 2026-04-29 20:48:01 -07:00
data-science
devops feat(kanban): hallucination gate + recovery UX for worker-created-card claims (#20232) 2026-05-05 08:06:55 -07:00
diagramming
dogfood
domain
email fix(skills/email/himalaya): document v1.2.0 folder.aliases syntax 2026-05-04 12:39:49 -07:00
gaming
gifs
github
index-cache
inference-sh
mcp
media
mlops
note-taking docs(skills): modernize Obsidian file workflows 2026-05-05 13:51:56 -07:00
productivity feat(skills/linear): add Documents support + Python helper script (#20752) 2026-05-06 08:27:21 -07:00
red-teaming/godmode
research
smart-home
social-media
software-development skills: adapt spike/sketch + 2 references from gsd-build/get-shit-done (MIT) (#17421) 2026-04-29 06:10:05 -07:00
yuanbao