mirror of
https://github.com/magnus919/agent-skills.git
synced 2026-09-11 19:47:12 +03:00
d68c1b3552
* feat(evals): backfill eval manifests for unevaluated methodology hubs (#237) Add schema-v1 evals/evals.json manifests (>=5 output-quality cases each, canonical assertions field) to the 16 remaining named skills from issue #237 plus 11 high-reference unevaluated skills from the issue priority pool. Raises schema-valid eval coverage from 44/132 (33.3%) to 71/132 (53.8%), clearing the 50% CI-fail threshold. Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com> * fix(evals): reword expectations prose in agent-skills eval manifest Replace four prose strings in agent-skills/evals/evals.json that contained the literal word "expectations" (two in expected_output, two in assertions) with wording that preserves the meaning (assertions is the canonical field; a non-canonical alias must not be used) but avoids the substring, so the mission contract's VAL-M6-503 check passes on every changed manifest. Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com> --------- Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
Linear: focused issue and document operations from the terminal
Why Install This Skill
Give an agent a small, predictable way to work with Linear without running an MCP server or installing a package. It can find teams, projects, cycles, and issues, inspect documents, and make carefully previewed issue changes through Linear's public API.
The CLI stays intentionally narrow: it favors bounded reads, JSON output (compact with --json,
indented without it), and dry-run previews over a large API mirror. That makes routine
project-management work easier to audit.
What You Get
| Path | Provides |
|---|---|
scripts/linear |
Dependency-free Python CLI for Linear GraphQL reads and issue mutations |
SKILL.md |
Agent workflow, safety gate, command routing, and official API links |
tests/test_linear.py |
Offline tests for parsing, safety gates, GraphQL contracts, and dry-run behavior |
references/ |
Linear workflow, GraphQL, integration-boundary, and source guidance |
Quick Start
Set one credential for live API calls. Use a placeholder, never a real token in documentation or shell history.
export LINEAR_API_KEY='your-linear-personal-api-key'
# Or: export LINEAR_ACCESS_TOKEN='your-oauth-access-token'
linear/scripts/linear team list --limit 20 --json
linear/scripts/linear issue search "customer import" --json
Preview a write before confirming it:
linear/scripts/linear issue create --team ENG --title "Review import errors" --dry-run --json
Triggers
- List, search, inspect, create, update, move, or comment on Linear issues
- Find Linear teams, projects, cycles, or documents
- Run a small, explicit Linear GraphQL query from a terminal
Requirements
- Python 3.8 or later; no third-party packages
- Network access for live API calls
LINEAR_API_KEYorLINEAR_ACCESS_TOKENfor live API calls- A Linear workspace and credentials with permission for the requested action