Skip to content

aiskillstore/marketplace / skills/0xsero/linear

linear

Verified

Linear issue tracking integration - Create, update, and manage Linear issues and projects using the GraphQL API

FileKindSize
SKILL.mdskill md3.5 KB
skill-report.jsonconfig42.3 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-04T14:33:47.266Z",
    "slug": "0xsero-linear",
    "source_url": "https://github.com/0xSero/orchestra/tree/main/examples/orchestra/.opencode/skill/linear",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "6760ba377aaf9e93bbc948fb160eccf610ec507e8d6969952466c0efbde6d094",
    "tree_hash": "44759bcd67e1c7fddac48af4cd39afb9a3399f0a67e9cd25bfe509820765e85e",
    "provenance": {
      "model_effective": "codex",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "linear",
    "description": "Manage Linear issues, comments, states, and project status through Linear GraphQL API workflows.",
    "summary": "Guides AI agents through authenticated Linear issue and project operations.",
    "icon": "📦",
    "version": "1.0.1",
    "author": "0xSero",
    "license": "MIT",
    "tags": [
      "linear",
      "issue-tracking",
      "project-management",
      "graphql",
      "workflow-automation"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "network",
      "filesystem",
      "env_access"
    ],
    "category": "productivity"
  },
  "security_audit": {
    "risk_level": "high",
    "is_blocked": false,
    "safe_to_publish": false,
    "analysis_status": "ok",
    "summary": "Most static command-execution findings are Markdown false positives from inline code, GraphQL examples, and code-fence delimiters. Confirmed risks are the intended curl-based Linear API call, use of LINEAR_API_KEY in an authorization header, hidden .opencode read access, and inherited MCP tool access. The denied .env and .key patterns are protective rules, not sensitive-file reads.",
    "remediation": [
      {
        "issue": "Credential-bearing curl command",
        "suggestion": "Avoid printing commands that include LINEAR_API_KEY, keep requests on the official Linear endpoint by default, and build JSON payloads with proper escaping.",
        "severity": "high"
      },
      {
        "issue": "Custom API endpoint can receive Linear credentials",
        "suggestion": "Require explicit user confirmation before sending LINEAR_API_KEY to any endpoint other than https://api.linear.app/graphql.",
        "severity": "medium"
      },
      {
        "issue": "Inherited MCP tool access",
        "suggestion": "Replace inheritAll with an explicit allowlist of MCP tools needed for Linear workflows, or disable inherited MCP access.",
        "severity": "high"
      },
      {
        "issue": "Hidden .opencode read access",
        "suggestion": "Narrow the allowed path to the exact Linear skill files needed, and keep secret-like files denied.",
        "severity": "medium"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 65,
            "line_end": 65
          },
          {
            "file": "SKILL.md",
            "line_start": 66,
            "line_end": 66
          },
          {
            "file": "SKILL.md",
            "line_start": 69,
            "line_end": 69
          },
          {
            "file": "SKILL.md",
            "line_start": 70,
            "line_end": 70
          },
          {
            "file": "SKILL.md",
            "line_start": 76,
            "line_end": 81
          },
          {
            "file": "SKILL.md",
            "line_start": 81,
            "line_end": 86
          },
          {
            "file": "SKILL.md",
            "line_start": 86,
            "line_end": 94
          },
          {
            "file": "SKILL.md",
            "line_start": 94,
            "line_end": 97
          },
          {
            "file": "SKILL.md",
            "line_start": 97,
            "line_end": 108
          },
          {
            "file": "SKILL.md",
            "line_start": 108,
            "line_end": 111
          },
          {
            "file": "SKILL.md",
            "line_start": 111,
            "line_end": 120
          },
          {
            "file": "SKILL.md",
            "line_start": 120,
            "line_end": 123
          },
          {
            "file": "SKILL.md",
            "line_start": 123,
            "line_end": 134
          },
          {
            "file": "SKILL.md",
            "line_start": 134,
            "line_end": 137
          },
          {
            "file": "SKILL.md",
            "line_start": 137,
            "line_end": 149
          },
          {
            "file": "SKILL.md",
            "line_start": 149,
            "line_end": 152
          },
          {
            "file": "SKILL.md",
            "line_start": 152,
            "line_end": 162
          },
          {
            "file": "SKILL.md",
            "line_start": 162,
            "line_end": 165
          },
          {
            "file": "SKILL.md",
            "line_start": 165,
            "line_end": 177
          },
          {
            "file": "SKILL.md",
            "line_start": 177,
            "line_end": 191
          },
          {
            "file": "SKILL.md",
            "line_start": 191,
            "line_end": 192
          },
          {
            "file": "SKILL.md",
            "line_start": 192,
            "line_end": 193
          },
          {
            "file": "SKILL.md",
            "line_start": 193,
            "line_end": 194
          },
          {
            "file": "SKILL.md",
            "line_start": 194,
            "line_end": 195
          },
          {
            "file": "SKILL.md",
            "line_start": 195,
            "line_end": 200
          },
          {
            "file": "SKILL.md",
            "line_start": 200,
            "line_end": 206
          }
        ]
      },
      {
        "factor": "network",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 69,
            "line_end": 69
          },
          {
            "file": "SKILL.md",
            "line_start": 77,
            "line_end": 77
          }
        ]
      },
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 26
          }
        ]
      },
      {
        "factor": "env_access",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 65,
            "line_end": 65
          },
          {
            "file": "SKILL.md",
            "line_start": 79,
            "line_end": 79
          },
          {
            "file": "SKILL.md",
            "line_start": 211,
            "line_end": 211
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:SKILL.md:65:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 65,
        "line_end": 65,
        "snippet": "- `LINEAR_API_KEY` - Your Linear API key"
      },
      {
        "id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 66,
        "line_end": 66,
        "snippet": "- `LINEAR_TEAM_ID` - The team ID to create issues in"
      },
      {
        "id": "external_commands:SKILL.md:69:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 69,
        "line_end": 69,
        "snippet": "- `LINEAR_API_URL` - Custom API endpoint (default: https://api.linear.app/graphql)"
      },
      {
        "id": "external_commands:SKILL.md:70:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 70,
        "line_end": 70,
        "snippet": "- `LINEAR_PROJECT_PREFIX` - Auto-prefix for project names"
      },
      {
        "id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 76,
        "line_end": 81,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:81:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 81,
        "line_end": 86,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:86:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 86,
        "line_end": 94,
        "snippet": "```graphql"
      },
      {
        "id": "external_commands:SKILL.md:94:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 94,
        "line_end": 97,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:97:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 97,
        "line_end": 108,
        "snippet": "```graphql"
      },
      {
        "id": "external_commands:SKILL.md:108:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 108,
        "line_end": 111,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 111,
        "line_end": 120,
        "snippet": "```json"
      },
      {
        "id": "external_commands:SKILL.md:120:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 120,
        "line_end": 123,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 123,
        "line_end": 134,
        "snippet": "```graphql"
      },
      {
        "id": "external_commands:SKILL.md:134:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 134,
        "line_end": 137,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:137:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 137,
        "line_end": 149,
        "snippet": "```graphql"
      },
      {
        "id": "external_commands:SKILL.md:149:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 149,
        "line_end": 152,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:152:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 152,
        "line_end": 162,
        "snippet": "```graphql"
      },
      {
        "id": "external_commands:SKILL.md:162:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 162,
        "line_end": 165,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:165:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 165,
        "line_end": 177,
        "snippet": "```graphql"
      },
      {
        "id": "external_commands:SKILL.md:177:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 177,
        "line_end": 191,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:191:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 191,
        "line_end": 192,
        "snippet": "- `backlog` - Backlog items"
      },
      {
        "id": "external_commands:SKILL.md:192:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 192,
        "line_end": 193,
        "snippet": "- `unstarted` - Todo/Not started"
      },
      {
        "id": "external_commands:SKILL.md:193:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 193,
        "line_end": 194,
        "snippet": "- `started` - In progress"
      },
      {
        "id": "external_commands:SKILL.md:194:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 194,
        "line_end": 195,
        "snippet": "- `completed` - Done"
      },
      {
        "id": "external_commands:SKILL.md:195:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 195,
        "line_end": 200,
        "snippet": "- `canceled` - Canceled"
      },
      {
        "id": "external_commands:SKILL.md:200:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 200,
        "line_end": 206,
        "snippet": "```"
      },
      {
        "id": "network:SKILL.md:69:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 69,
        "line_end": 69,
        "snippet": "- `LINEAR_API_URL` - Custom API endpoint (default: https://api.linear.app/graphql)"
      },
      {
        "id": "network:SKILL.md:77:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 77,
        "line_end": 77,
        "snippet": "curl -X POST https://api.linear.app/graphql \\"
      },
      {
        "id": "filesystem:SKILL.md:26:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "SKILL.md",
        "line_start": 26,
        "line_end": 26,
        "snippet": "- \"**/.opencode/**\""
      },
      {
        "id": "env_access:SKILL.md:65:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "SKILL.md",
        "line_start": 65,
        "line_end": 65,
        "snippet": "- `LINEAR_API_KEY` - Your Linear API key"
      },
      {
        "id": "env_access:SKILL.md:79:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "SKILL.md",
        "line_start": 79,
        "line_end": 79,
        "snippet": "-H \"Authorization: $LINEAR_API_KEY\" \\"
      },
      {
        "id": "env_access:SKILL.md:211:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "SKILL.md",
        "line_start": 211,
        "line_end": 211,
        "snippet": "- Log or expose the LINEAR_API_KEY"
      },
      {
        "id": "sensitive:SKILL.md:28:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "SKILL.md",
        "line_start": 28,
        "line_end": 28,
        "snippet": "- \"**/*.env*\""
      },
      {
        "id": "sensitive:SKILL.md:29:certificate-key-files",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Certificate/key files",
        "file": "SKILL.md",
        "line_start": 29,
        "line_end": 29,
        "snippet": "- \"**/*.key\""
      },
      {
        "id": "blocker:SKILL.md:89:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 89,
        "line_end": 90,
        "snippet": "id"
      },
      {
        "id": "blocker:SKILL.md:102:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 102,
        "line_end": 103,
        "snippet": "id"
      },
      {
        "id": "blocker:SKILL.md:128:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 128,
        "line_end": 129,
        "snippet": "id"
      },
      {
        "id": "blocker:SKILL.md:142:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 142,
        "line_end": 143,
        "snippet": "id"
      },
      {
        "id": "blocker:SKILL.md:157:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 157,
        "line_end": 158,
        "snippet": "id"
      },
      {
        "id": "blocker:SKILL.md:168:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 168,
        "line_end": 169,
        "snippet": "id"
      },
      {
        "id": "blocker:SKILL.md:193:network-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "Network reconnaissance",
        "file": "SKILL.md",
        "line_start": 193,
        "line_end": 194,
        "snippet": "- `started` - In progress"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:SKILL.md:65:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "This line names LINEAR_API_KEY in Markdown inline code. It does not execute a shell command or interpolate user input."
      },
      {
        "id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "This line documents LINEAR_TEAM_ID in Markdown inline code. There is no command execution on this line."
      },
      {
        "id": "external_commands:SKILL.md:69:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "This line documents LINEAR_API_URL in Markdown inline code and an official default URL. It is not a shell execution primitive."
      },
      {
        "id": "external_commands:SKILL.md:70:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "This line documents LINEAR_PROJECT_PREFIX in Markdown inline code. It does not invoke Ruby or a shell."
      },
      {
        "id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
        "verdict": "confirmed",
        "confidence": 0.82,
        "reason": "The fenced bash example tells the agent to run curl against Linear with an authorization header. This is intended behavior, but it is real external command execution with credential handling risk.",
        "severity": "medium"
      },
      {
        "id": "external_commands:SKILL.md:81:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The snippet is a Markdown code-fence delimiter or output-format block. It is documentation text, not executable shell code."
      },
      {
        "id": "external_commands:SKILL.md:86:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The fenced block contains GraphQL examples for Linear operations. GraphQL text is not local shell execution."
      },
      {
        "id": "external_commands:SKILL.md:94:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The snippet is a Markdown code-fence delimiter or output-format block. It is documentation text, not executable shell code."
      },
      {
        "id": "external_commands:SKILL.md:97:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The fenced block contains GraphQL examples for Linear operations. GraphQL text is not local shell execution."
      },
      {
        "id": "external_commands:SKILL.md:108:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The snippet is a Markdown code-fence delimiter or output-format block. It is documentation text, not executable shell code."
      },
      {
        "id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The fenced block contains JSON variables for a Linear mutation. It does not execute commands."
      },
      {
        "id": "external_commands:SKILL.md:120:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The snippet is a Markdown code-fence delimiter or output-format block. It is documentation text, not executable shell code."
      },
      {
        "id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The fenced block contains GraphQL examples for Linear operations. GraphQL text is not local shell execution."
      },
      {
        "id": "external_commands:SKILL.md:134:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The snippet is a Markdown code-fence delimiter or output-format block. It is documentation text, not executable shell code."
      },
      {
        "id": "external_commands:SKILL.md:137:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The fenced block contains GraphQL examples for Linear operations. GraphQL text is not local shell execution."
      },
      {
        "id": "external_commands:SKILL.md:149:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The snippet is a Markdown code-fence delimiter or output-format block. It is documentation text, not executable shell code."
      },
      {
        "id": "external_commands:SKILL.md:152:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The fenced block contains GraphQL examples for Linear operations. GraphQL text is not local shell execution."
      },
      {
        "id": "external_commands:SKILL.md:162:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The snippet is a Markdown code-fence delimiter or output-format block. It is documentation text, not executable shell code."
      },
      {
        "id": "external_commands:SKILL.md:165:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The fenced block contains GraphQL examples for Linear operations. GraphQL text is not local shell execution."
      },
      {
        "id": "external_commands:SKILL.md:177:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The snippet is a Markdown code-fence delimiter or output-format block. It is documentation text, not executable shell code."
      },
      {
        "id": "external_commands:SKILL.md:191:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The backticks wrap Linear state names in prose. They are not Ruby backticks or shell execution."
      },
      {
        "id": "external_commands:SKILL.md:192:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The backticks wrap Linear state names in prose. They are not Ruby backticks or shell execution."
      },
      {
        "id": "external_commands:SKILL.md:193:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The backticks wrap Linear state names in prose. They are not Ruby backticks or shell execution."
      },
      {
        "id": "external_commands:SKILL.md:194:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The backticks wrap Linear state names in prose. They are not Ruby backticks or shell execution."
      },
      {
        "id": "external_commands:SKILL.md:195:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The backticks wrap Linear state names in prose. They are not Ruby backticks or shell execution."
      },
      {
        "id": "external_commands:SKILL.md:200:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The snippet is a Markdown code-fence delimiter or output-format block. It is documentation text, not executable shell code."
      },
      {
        "id": "network:SKILL.md:69:hardcoded-url",
        "verdict": "confirmed",
        "confidence": 0.58,
        "reason": "The skill documents a custom API endpoint setting for Linear requests. This is legitimate, but endpoint changes could redirect credential-bearing API calls if misconfigured.",
        "severity": "low"
      },
      {
        "id": "network:SKILL.md:77:hardcoded-url",
        "verdict": "confirmed",
        "confidence": 0.82,
        "reason": "The curl example sends outbound requests to the Linear GraphQL API. Network access is expected, but it transmits workspace data and authorization material to a third-party service.",
        "severity": "low"
      },
      {
        "id": "filesystem:SKILL.md:26:hidden-file-access",
        "verdict": "confirmed",
        "confidence": 0.72,
        "reason": "The permission block allows reading hidden .opencode files. This is scoped, but hidden agent configuration can contain sensitive workflow context.",
        "severity": "medium"
      },
      {
        "id": "env_access:SKILL.md:65:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.78,
        "reason": "This line lists the required LINEAR_API_KEY variable but does not read or expose a value. The real credential-use risk appears in the curl authorization header."
      },
      {
        "id": "env_access:SKILL.md:79:generic-api-secret-keys",
        "verdict": "confirmed",
        "confidence": 0.9,
        "reason": "The curl example places LINEAR_API_KEY in an Authorization header. This is necessary for Linear access, but it is high-impact if logged, redirected, or exposed through process arguments.",
        "severity": "high"
      },
      {
        "id": "env_access:SKILL.md:211:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This line is a security rule telling users never to log or expose LINEAR_API_KEY. It is protective guidance, not secret access."
      },
      {
        "id": "sensitive:SKILL.md:28:environment-file-access",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The pattern appears under denied paths, explicitly blocking .env file access. This reduces risk rather than enabling it."
      },
      {
        "id": "sensitive:SKILL.md:29:certificate-key-files",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The pattern appears under denied paths, explicitly blocking .key file access. This is a protective permission rule."
      },
      {
        "id": "blocker:SKILL.md:89:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The snippet is a GraphQL field name or Linear state label in documentation. It is not system or network reconnaissance."
      },
      {
        "id": "blocker:SKILL.md:102:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The snippet is a GraphQL field name or Linear state label in documentation. It is not system or network reconnaissance."
      },
      {
        "id": "blocker:SKILL.md:128:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The snippet is a GraphQL field name or Linear state label in documentation. It is not system or network reconnaissance."
      },
      {
        "id": "blocker:SKILL.md:142:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The snippet is a GraphQL field name or Linear state label in documentation. It is not system or network reconnaissance."
      },
      {
        "id": "blocker:SKILL.md:157:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The snippet is a GraphQL field name or Linear state label in documentation. It is not system or network reconnaissance."
      },
      {
        "id": "blocker:SKILL.md:168:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The snippet is a GraphQL field name or Linear state label in documentation. It is not system or network reconnaissance."
      },
      {
        "id": "blocker:SKILL.md:193:network-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The snippet is a GraphQL field name or Linear state label in documentation. It is not system or network reconnaissance."
      }
    ],
    "semantic_findings": [
      {
        "title": "Inherited MCP Tool Access",
        "description": "The skill sets mcp inheritAll to true, which can expose every configured MCP tool to this workflow. This broadens the trust boundary beyond the declared Linear integration.",
        "severity": "high",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 41,
            "line_end": 42
          }
        ],
        "confidence": 0.78,
        "confidence_reasoning": "The configuration explicitly enables inherited MCP access. The risk depends on the user environment, but the broad permission is clear in the skill file."
      }
    ],
    "critical_findings": [],
    "high_findings": [
      {
        "title": "Generic API/secret keys",
        "description": "-H \"Authorization: $LINEAR_API_KEY\" \\",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 79,
            "line_end": 79
          }
        ],
        "review_kind": "capability",
        "source_category": "env_access",
        "source_severity": "high",
        "confidence": 0.9,
        "confidence_reasoning": "The curl example places LINEAR_API_KEY in an Authorization header. This is necessary for Linear access, but it is high-impact if logged, redirected, or exposed through process arguments."
      },
      {
        "title": "Inherited MCP Tool Access",
        "description": "The skill sets mcp inheritAll to true, which can expose every configured MCP tool to this workflow. This broadens the trust boundary beyond the declared Linear integration.",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 41,
            "line_end": 42
          }
        ],
        "review_kind": "security",
        "source_category": "semantic",
        "source_severity": "high",
        "confidence": 0.78,
        "confidence_reasoning": "The configuration explicitly enables inherited MCP access. The risk depends on the user environment, but the broad permission is clear in the skill file."
      }
    ],
    "medium_findings": [
      {
        "title": "Ruby/shell backtick execution",
        "description": "```bash",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 76,
            "line_end": 81
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.82,
        "confidence_reasoning": "The fenced bash example tells the agent to run curl against Linear with an authorization header. This is intended behavior, but it is real external command execution with credential handling risk."
      },
      {
        "title": "Hidden file access",
        "description": "- \"**/.opencode/**\"",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 26
          }
        ],
        "review_kind": "capability",
        "source_category": "filesystem",
        "source_severity": "medium",
        "confidence": 0.72,
        "confidence_reasoning": "The permission block allows reading hidden .opencode files. This is scoped, but hidden agent configuration can contain sensitive workflow context."
      }
    ],
    "low_findings": [
      {
        "title": "Hardcoded URL",
        "description": "- `LINEAR_API_URL` - Custom API endpoint (default: https://api.linear.app/graphql)",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 69,
            "line_end": 69
          }
        ],
        "review_kind": "capability",
        "source_category": "network",
        "source_severity": "low",
        "confidence": 0.58,
        "confidence_reasoning": "The skill documents a custom API endpoint setting for Linear requests. This is legitimate, but endpoint changes could redirect credential-bearing API calls if misconfigured."
      },
      {
        "title": "Hardcoded URL",
        "description": "curl -X POST https://api.linear.app/graphql \\",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 77,
            "line_end": 77
          }
        ],
        "review_kind": "capability",
        "source_category": "network",
        "source_severity": "low",
        "confidence": 0.82,
        "confidence_reasoning": "The curl example sends outbound requests to the Linear GraphQL API. Network access is expected, but it transmits workspace data and authorization material to a third-party service."
      }
    ],
    "dangerous_patterns": [],
    "files_scanned": 1,
    "total_lines": 214,
    "audit_model": "codex",
    "audited_at": "2026-07-04T14:33:47.266Z",
    "agent_auto_install_policy": "confirmation_required",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Manage Linear Issues from AI Workflows",
    "value_statement": "Switching between AI work and Linear slows issue tracking. This skill guides Claude, Codex, and Claude Code through Linear GraphQL operations.",
    "seo_keywords": [
      "Linear integration",
      "Linear issue tracking",
      "Linear GraphQL API",
      "Claude",
      "Codex",
      "Claude Code",
      "AI project management",
      "issue creation",
      "Linear automation",
      "developer workflow"
    ],
    "actual_capabilities": [
      "Creates Linear issues with title, description, team, and priority fields.",
      "Updates Linear issues through documented GraphQL mutations.",
      "Adds comments to issues using Linear comment creation workflows.",
      "Queries the current user, team states, and project status.",
      "Explains Linear priority numbers and state types for consistent updates.",
      "Uses Linear environment variables for authenticated API requests."
    ],
    "limitations": [
      "Requires a valid Linear API key and team ID in the environment.",
      "Uses bash and curl examples instead of a dedicated Linear SDK.",
      "Does not validate future Linear GraphQL schema changes locally.",
      "Can return sensitive workspace data when prompts request broad API responses."
    ],
    "use_cases": [
      {
        "title": "Create Engineering Tasks",
        "description": "Turn implementation notes, bugs, or review comments into Linear issues with priority and ownership context.",
        "target_user": "Software developer"
      },
      {
        "title": "Track Project Health",
        "description": "Query Linear project status, progress, issue counts, and completion metrics from an AI-assisted workflow.",
        "target_user": "Product manager"
      },
      {
        "title": "Record Customer Follow-up",
        "description": "Add comments or create tracked issues from support findings without leaving the current assistant session.",
        "target_user": "Support lead"
      }
    ],
    "prompt_templates": [
      {
        "title": "Create a Basic Issue",
        "scenario": "Beginner issue creation",
        "prompt": "Create a Linear issue for this problem: [summary]. Use team [team] and priority [priority]. Return the identifier and link."
      },
      {
        "title": "Update Issue Status",
        "scenario": "Routine issue maintenance",
        "prompt": "Update Linear issue [identifier] to [state]. Add a short note explaining the reason for the status change."
      },
      {
        "title": "Check Project Progress",
        "scenario": "Project reporting",
        "prompt": "Get the current status for Linear project [project name or ID]. Summarize progress, open work, and completed work."
      },
      {
        "title": "Triage Multiple Findings",
        "scenario": "Advanced issue workflow",
        "prompt": "Review these findings and create or update Linear issues as needed: [findings]. Group duplicates, set priorities, and report every action."
      }
    ],
    "output_examples": [
      {
        "input": "Create an issue for failed password reset emails.",
        "output": "Linear action completed. Type: create issue. Identifier: ENG-123. URL: Linear issue link. Details: High priority bug with reproduction notes."
      },
      {
        "input": "Move ENG-123 to In Progress and explain why.",
        "output": "Linear action completed. Type: update issue. Identifier: ENG-123. URL: Linear issue link. Details: State changed to In Progress with an implementation note."
      },
      {
        "input": "Summarize the Billing Revamp project status.",
        "output": "Project status returned. The project is active, progress is available, and completed versus total issue counts are summarized."
      }
    ],
    "best_practices": [
      "Keep LINEAR_API_KEY in environment variables and never paste it into prompts.",
      "Ask for a specific issue, project, or team before sending API requests.",
      "Review generated issue titles and descriptions before creating customer-visible work."
    ],
    "anti_patterns": [
      "Do not send broad workspace queries when a narrow issue or project query is enough.",
      "Do not route Linear API calls to custom endpoints without confirming the destination.",
      "Do not include secrets, private customer data, or access tokens in issue descriptions."
    ],
    "faq": [
      {
        "question": "What credentials does this skill need?",
        "answer": "It needs LINEAR_API_KEY and LINEAR_TEAM_ID in the environment for authenticated Linear API requests."
      },
      {
        "question": "Can it create new Linear issues?",
        "answer": "Yes. It provides a GraphQL mutation pattern for creating issues with title, description, team, and priority."
      },
      {
        "question": "Can it update issue status?",
        "answer": "Yes. It includes update guidance and team state queries so the assistant can choose valid Linear states."
      },
      {
        "question": "Does it use the official Linear API?",
        "answer": "Yes. The examples use the official Linear GraphQL endpoint by default."
      },
      {
        "question": "Is this a full Linear client?",
        "answer": "No. It is a prompt and API workflow guide, not a packaged application or SDK."
      },
      {
        "question": "What should I check before publishing data?",
        "answer": "Review issue text, comments, and query results for secrets or sensitive customer information."
      }
    ]
  },
  "file_structure": [
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 214
    }
  ]
}
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall