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
@schpetbot

Copy link
Copy Markdown
Collaborator Author

Shipped in v2.6.0.

The Markdown guidance is out.

  • A top-level linear markdown reference covers mentions and collapsible sections.
  • The ten commands that take a Markdown body carry the rule inline — @name mentions nobody; a plain Linear URL does — and point at that reference.
  • team members --json / user list --json explain what the url field is for.

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