Skip to content

Teach Linear Markdown to agents without the skill - #275

Merged
schpetbot merged 1 commit into
mainfrom
schpet/push-xuknunzpwxzy
Sep 1, 2026
Merged

Teach Linear Markdown to agents without the skill#275
schpetbot merged 1 commit into
mainfrom
schpet/push-xuknunzpwxzy

Conversation

@schpetbot

Copy link
Copy Markdown
Collaborator

Summary

  • add a top-level linear markdown reference for mentions and collapsible sections
  • embed mention guidance in every Markdown-authoring command
  • explain the mention-ready url field in team and workspace member JSON output
  • regenerate skill docs and add regression coverage

Verification

  • deno fmt
  • deno task validate
  • deno task test (613 passed, 6 ignored)

The skill learned how Linear mentions actually work; the CLI itself did not.
An agent driving `linear` without it still writes `@peter` in a comment body
and posts text that notifies nobody.

Put the trap-avoiding rule inline on the ten commands that take a Markdown
body, because a pointer alone only helps an agent that already suspects it has
a gap. The full reference lives in a new `linear markdown` command, used both
as its description and as what it prints: printing keeps the `+++` block
unindented and copyable, and the description is what the skill-docs generator
captures from `--help`. The `--json` listings say what the `url` field is for,
with the team-first safeguard kept on the workspace-wide one.

Help screens grow by one root row and about five lines per authoring command;
parent command tables are unaffected, since cliffy renders only a
description's first line there.

Claude-Session: https://claude.ai/code/session_01TWeJWzhCAW61GLqv2kTpNB
@schpetbot
schpetbot merged commit 3c30f36 into main Sep 1, 2026
15 checks passed
@schpetbot
schpetbot deleted the schpet/push-xuknunzpwxzy branch September 1, 2026 23:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants