Skip to content

Commit 2c32fb8

Browse files
committed
fix: add tool availability section to prevent MCP-not-found errors
Added prominent section at top of SKILL.md that: - Explains multiple tool backends (MCP, CLI, scripts) - Provides CLI examples for common operations - Explicitly states not to report MCP unavailability as a blocker
1 parent 75f2241 commit 2c32fb8

File tree

1 file changed

+31
-0
lines changed

1 file changed

+31
-0
lines changed

skills/linear/SKILL.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,37 @@ Tools and workflows for managing issues, projects, and teams in Linear.
1313

1414
---
1515

16+
## ⚠️ Tool Availability (READ FIRST)
17+
18+
**This skill supports multiple tool backends. Use whichever is available:**
19+
20+
1. **MCP Tools (mcp__linear)** - Use if available in your tool set
21+
2. **Linear CLI (`linear` command)** - Always available via Bash
22+
3. **Helper Scripts** - For complex operations
23+
24+
**If MCP tools are NOT available**, use the Linear CLI via Bash:
25+
26+
```bash
27+
# View an issue
28+
linear issues view SMI-123
29+
30+
# Create an issue
31+
linear issues create --title "Issue title" --description "Description"
32+
33+
# Update issue status (get state IDs first)
34+
linear issues update SMI-123 -s "STATE_ID"
35+
36+
# Add a comment
37+
linear issues comment add SMI-123 -m "Comment text"
38+
39+
# List issues
40+
linear issues list
41+
```
42+
43+
**Do NOT report "MCP tools not available" as a blocker** - use CLI instead.
44+
45+
---
46+
1647
## 🔐 Security: Varlock Integration
1748

1849
**CRITICAL**: Never expose API keys in terminal output or Claude's context.

0 commit comments

Comments
 (0)