Skip to content

aiskillstore/marketplace / skills/89jobrien/cocoindex

cocoindex

Verified

Comprehensive toolkit for developing with the CocoIndex library. Use when users need to create data transformation pipelines (flows), write custom functions, or operate flows via CLI or API. Covers building ETL workflows for AI data processing, including embedding documents into vector databases, building knowledge graphs, creating search indexes, or processing data streams with incremental updates.

FileKindSize
SKILL.mdskill md25.2 KB
references/api-operations.mdmarkdown13.3 KB
references/cli-operations.mdmarkdown8.8 KB
references/custom-functions.mdmarkdown13.5 KB
references/flow-patterns.mdmarkdown13.7 KB
skill-report.jsonconfig173.3 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-05T11:19:52.681Z",
    "slug": "89jobrien-cocoindex",
    "source_url": "https://github.com/89jobrien/steve/tree/main/steve/skills/cocoindex",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "5fe006e73bc771db9ee1e6ba67c9d8d7e7003f8ba47a3ee07ca2f2e3da3305b7",
    "tree_hash": "ce03bb9e7523c52e8b8a30abaf30c3f60796bf6535e8e89dcb30ab2eb9d563e8",
    "provenance": {
      "model_effective": "codex",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "cocoindex",
    "description": "CocoIndex development guide for building AI data transformation pipelines, custom functions, query handlers, and operational workflows. It covers flows, embeddings, knowledge graphs, vector search exports, CLI operations, and Python API patterns.",
    "summary": "Build and operate CocoIndex flows for AI data indexing, search, and extraction.",
    "icon": "📦",
    "version": "1.0.2",
    "author": "Joseph OBrien",
    "license": "MIT",
    "tags": [
      "cocoindex",
      "data-pipelines",
      "vector-search",
      "embeddings",
      "knowledge-graphs"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "scripts",
      "network",
      "env_access",
      "filesystem",
      "external_commands"
    ],
    "category": "data"
  },
  "security_audit": {
    "risk_level": "high",
    "is_blocked": false,
    "safe_to_publish": false,
    "analysis_status": "ok",
    "summary": "Most static findings are Markdown documentation samples or CocoIndex API examples, including false positives for Markdown backticks and transform_flow.eval(). Confirmed risks remain around secret exposure during troubleshooting, instructions to collect API key values in chat, and destructive flow commands that need explicit confirmation. No evidence of prompt injection was found in the reviewed files.",
    "remediation": [
      {
        "issue": "The skill tells assistants to ask users for API key values when keys are missing.",
        "suggestion": "Replace this with guidance to create environment variables locally, use secret managers, and never paste secret values into chat.",
        "severity": "high"
      },
      {
        "issue": "Troubleshooting commands can reveal database URLs from .env files or process arguments.",
        "suggestion": "Use redacted checks, connection tests that do not echo credentials, and instructions that prevent agents from printing secret values.",
        "severity": "high"
      },
      {
        "issue": "Reset, drop, and force setup commands can remove resources or bypass prompts.",
        "suggestion": "Require explicit user confirmation, name the target environment, and recommend backups before destructive CocoIndex operations.",
        "severity": "medium"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "scripts",
        "evidence": [
          {
            "file": "references/api-operations.md",
            "line_start": 271,
            "line_end": 271
          },
          {
            "file": "references/api-operations.md",
            "line_start": 302,
            "line_end": 302
          },
          {
            "file": "references/api-operations.md",
            "line_start": 360,
            "line_end": 360
          },
          {
            "file": "references/flow-patterns.md",
            "line_start": 338,
            "line_end": 338
          },
          {
            "file": "SKILL.md",
            "line_start": 572,
            "line_end": 572
          }
        ]
      },
      {
        "factor": "network",
        "evidence": [
          {
            "file": "references/api-operations.md",
            "line_start": 348,
            "line_end": 348
          },
          {
            "file": "references/custom-functions.md",
            "line_start": 427,
            "line_end": 427
          },
          {
            "file": "SKILL.md",
            "line_start": 36,
            "line_end": 36
          },
          {
            "file": "SKILL.md",
            "line_start": 37,
            "line_end": 37
          },
          {
            "file": "SKILL.md",
            "line_start": 99,
            "line_end": 99
          },
          {
            "file": "SKILL.md",
            "line_start": 133,
            "line_end": 133
          },
          {
            "file": "SKILL.md",
            "line_start": 244,
            "line_end": 244
          },
          {
            "file": "SKILL.md",
            "line_start": 286,
            "line_end": 286
          },
          {
            "file": "SKILL.md",
            "line_start": 366,
            "line_end": 366
          },
          {
            "file": "SKILL.md",
            "line_start": 447,
            "line_end": 447
          },
          {
            "file": "SKILL.md",
            "line_start": 499,
            "line_end": 499
          },
          {
            "file": "SKILL.md",
            "line_start": 577,
            "line_end": 577
          },
          {
            "file": "SKILL.md",
            "line_start": 685,
            "line_end": 685
          },
          {
            "file": "SKILL.md",
            "line_start": 686,
            "line_end": 686
          },
          {
            "file": "SKILL.md",
            "line_start": 840,
            "line_end": 840
          },
          {
            "file": "SKILL.md",
            "line_start": 841,
            "line_end": 841
          }
        ]
      },
      {
        "factor": "env_access",
        "evidence": [
          {
            "file": "references/api-operations.md",
            "line_start": 286,
            "line_end": 286
          },
          {
            "file": "references/api-operations.md",
            "line_start": 24,
            "line_end": 24
          },
          {
            "file": "references/api-operations.md",
            "line_start": 28,
            "line_end": 28
          },
          {
            "file": "references/api-operations.md",
            "line_start": 390,
            "line_end": 390
          },
          {
            "file": "references/api-operations.md",
            "line_start": 394,
            "line_end": 394
          },
          {
            "file": "references/api-operations.md",
            "line_start": 426,
            "line_end": 426
          },
          {
            "file": "references/api-operations.md",
            "line_start": 428,
            "line_end": 428
          },
          {
            "file": "references/api-operations.md",
            "line_start": 474,
            "line_end": 474
          },
          {
            "file": "references/api-operations.md",
            "line_start": 476,
            "line_end": 476
          },
          {
            "file": "references/api-operations.md",
            "line_start": 575,
            "line_end": 575
          },
          {
            "file": "references/api-operations.md",
            "line_start": 24,
            "line_end": 24
          },
          {
            "file": "references/api-operations.md",
            "line_start": 28,
            "line_end": 28
          },
          {
            "file": "references/api-operations.md",
            "line_start": 390,
            "line_end": 390
          },
          {
            "file": "references/api-operations.md",
            "line_start": 394,
            "line_end": 394
          },
          {
            "file": "references/api-operations.md",
            "line_start": 426,
            "line_end": 426
          },
          {
            "file": "references/api-operations.md",
            "line_start": 428,
            "line_end": 428
          },
          {
            "file": "references/api-operations.md",
            "line_start": 474,
            "line_end": 474
          },
          {
            "file": "references/api-operations.md",
            "line_start": 476,
            "line_end": 476
          },
          {
            "file": "references/api-operations.md",
            "line_start": 286,
            "line_end": 286
          },
          {
            "file": "references/cli-operations.md",
            "line_start": 27,
            "line_end": 27
          },
          {
            "file": "references/cli-operations.md",
            "line_start": 346,
            "line_end": 346
          },
          {
            "file": "references/cli-operations.md",
            "line_start": 349,
            "line_end": 349
          },
          {
            "file": "references/cli-operations.md",
            "line_start": 37,
            "line_end": 37
          },
          {
            "file": "references/cli-operations.md",
            "line_start": 38,
            "line_end": 38
          },
          {
            "file": "references/cli-operations.md",
            "line_start": 39,
            "line_end": 39
          },
          {
            "file": "references/custom-functions.md",
            "line_start": 397,
            "line_end": 397
          },
          {
            "file": "references/custom-functions.md",
            "line_start": 420,
            "line_end": 420
          },
          {
            "file": "references/custom-functions.md",
            "line_start": 429,
            "line_end": 429
          },
          {
            "file": "SKILL.md",
            "line_start": 139,
            "line_end": 139
          },
          {
            "file": "SKILL.md",
            "line_start": 148,
            "line_end": 148
          },
          {
            "file": "SKILL.md",
            "line_start": 506,
            "line_end": 506
          },
          {
            "file": "SKILL.md",
            "line_start": 509,
            "line_end": 509
          },
          {
            "file": "SKILL.md",
            "line_start": 139,
            "line_end": 139
          },
          {
            "file": "SKILL.md",
            "line_start": 148,
            "line_end": 148
          },
          {
            "file": "SKILL.md",
            "line_start": 506,
            "line_end": 506
          },
          {
            "file": "SKILL.md",
            "line_start": 509,
            "line_end": 509
          },
          {
            "file": "SKILL.md",
            "line_start": 105,
            "line_end": 105
          },
          {
            "file": "SKILL.md",
            "line_start": 123,
            "line_end": 123
          },
          {
            "file": "SKILL.md",
            "line_start": 805,
            "line_end": 805
          },
          {
            "file": "SKILL.md",
            "line_start": 806,
            "line_end": 806
          },
          {
            "file": "SKILL.md",
            "line_start": 126,
            "line_end": 126
          },
          {
            "file": "SKILL.md",
            "line_start": 127,
            "line_end": 127
          },
          {
            "file": "SKILL.md",
            "line_start": 128,
            "line_end": 128
          },
          {
            "file": "SKILL.md",
            "line_start": 129,
            "line_end": 129
          }
        ]
      },
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "references/cli-operations.md",
            "line_start": 49,
            "line_end": 49
          },
          {
            "file": "references/cli-operations.md",
            "line_start": 352,
            "line_end": 352
          }
        ]
      },
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 81,
            "line_end": 81
          },
          {
            "file": "SKILL.md",
            "line_start": 85,
            "line_end": 85
          },
          {
            "file": "SKILL.md",
            "line_start": 86,
            "line_end": 86
          },
          {
            "file": "SKILL.md",
            "line_start": 87,
            "line_end": 87
          },
          {
            "file": "SKILL.md",
            "line_start": 88,
            "line_end": 88
          },
          {
            "file": "SKILL.md",
            "line_start": 93,
            "line_end": 93
          },
          {
            "file": "SKILL.md",
            "line_start": 94,
            "line_end": 94
          },
          {
            "file": "SKILL.md",
            "line_start": 95,
            "line_end": 95
          },
          {
            "file": "SKILL.md",
            "line_start": 97,
            "line_end": 97
          },
          {
            "file": "SKILL.md",
            "line_start": 105,
            "line_end": 105
          },
          {
            "file": "SKILL.md",
            "line_start": 106,
            "line_end": 106
          },
          {
            "file": "SKILL.md",
            "line_start": 119,
            "line_end": 119
          },
          {
            "file": "SKILL.md",
            "line_start": 121,
            "line_end": 131
          },
          {
            "file": "SKILL.md",
            "line_start": 131,
            "line_end": 137
          },
          {
            "file": "SKILL.md",
            "line_start": 137,
            "line_end": 151
          },
          {
            "file": "SKILL.md",
            "line_start": 151,
            "line_end": 157
          },
          {
            "file": "SKILL.md",
            "line_start": 157,
            "line_end": 196
          },
          {
            "file": "SKILL.md",
            "line_start": 196,
            "line_end": 201
          },
          {
            "file": "SKILL.md",
            "line_start": 201,
            "line_end": 202
          },
          {
            "file": "SKILL.md",
            "line_start": 202,
            "line_end": 202
          },
          {
            "file": "SKILL.md",
            "line_start": 211,
            "line_end": 215
          },
          {
            "file": "SKILL.md",
            "line_start": 215,
            "line_end": 219
          },
          {
            "file": "SKILL.md",
            "line_start": 219,
            "line_end": 223
          },
          {
            "file": "SKILL.md",
            "line_start": 223,
            "line_end": 227
          },
          {
            "file": "SKILL.md",
            "line_start": 227,
            "line_end": 237
          },
          {
            "file": "SKILL.md",
            "line_start": 237,
            "line_end": 250
          },
          {
            "file": "SKILL.md",
            "line_start": 250,
            "line_end": 252
          },
          {
            "file": "SKILL.md",
            "line_start": 252,
            "line_end": 254
          },
          {
            "file": "SKILL.md",
            "line_start": 254,
            "line_end": 256
          },
          {
            "file": "SKILL.md",
            "line_start": 256,
            "line_end": 258
          },
          {
            "file": "SKILL.md",
            "line_start": 258,
            "line_end": 260
          },
          {
            "file": "SKILL.md",
            "line_start": 260,
            "line_end": 262
          },
          {
            "file": "SKILL.md",
            "line_start": 262,
            "line_end": 279
          },
          {
            "file": "SKILL.md",
            "line_start": 279,
            "line_end": 288
          },
          {
            "file": "SKILL.md",
            "line_start": 288,
            "line_end": 303
          },
          {
            "file": "SKILL.md",
            "line_start": 303,
            "line_end": 303
          },
          {
            "file": "SKILL.md",
            "line_start": 310,
            "line_end": 310
          },
          {
            "file": "SKILL.md",
            "line_start": 313,
            "line_end": 314
          },
          {
            "file": "SKILL.md",
            "line_start": 314,
            "line_end": 317
          },
          {
            "file": "SKILL.md",
            "line_start": 317,
            "line_end": 318
          },
          {
            "file": "SKILL.md",
            "line_start": 318,
            "line_end": 318
          },
          {
            "file": "SKILL.md",
            "line_start": 321,
            "line_end": 322
          },
          {
            "file": "SKILL.md",
            "line_start": 322,
            "line_end": 323
          },
          {
            "file": "SKILL.md",
            "line_start": 323,
            "line_end": 323
          },
          {
            "file": "SKILL.md",
            "line_start": 325,
            "line_end": 327
          },
          {
            "file": "SKILL.md",
            "line_start": 327,
            "line_end": 331
          },
          {
            "file": "SKILL.md",
            "line_start": 331,
            "line_end": 364
          },
          {
            "file": "SKILL.md",
            "line_start": 364,
            "line_end": 388
          },
          {
            "file": "SKILL.md",
            "line_start": 388,
            "line_end": 400
          },
          {
            "file": "SKILL.md",
            "line_start": 400,
            "line_end": 404
          },
          {
            "file": "SKILL.md",
            "line_start": 404,
            "line_end": 406
          },
          {
            "file": "SKILL.md",
            "line_start": 406,
            "line_end": 406
          },
          {
            "file": "SKILL.md",
            "line_start": 410,
            "line_end": 434
          },
          {
            "file": "SKILL.md",
            "line_start": 434,
            "line_end": 443
          },
          {
            "file": "SKILL.md",
            "line_start": 443,
            "line_end": 445
          },
          {
            "file": "SKILL.md",
            "line_start": 445,
            "line_end": 455
          },
          {
            "file": "SKILL.md",
            "line_start": 455,
            "line_end": 457
          },
          {
            "file": "SKILL.md",
            "line_start": 457,
            "line_end": 461
          },
          {
            "file": "SKILL.md",
            "line_start": 461,
            "line_end": 469
          },
          {
            "file": "SKILL.md",
            "line_start": 469,
            "line_end": 473
          },
          {
            "file": "SKILL.md",
            "line_start": 473,
            "line_end": 477
          },
          {
            "file": "SKILL.md",
            "line_start": 477,
            "line_end": 481
          },
          {
            "file": "SKILL.md",
            "line_start": 481,
            "line_end": 483
          },
          {
            "file": "SKILL.md",
            "line_start": 483,
            "line_end": 487
          },
          {
            "file": "SKILL.md",
            "line_start": 487,
            "line_end": 489
          },
          {
            "file": "SKILL.md",
            "line_start": 489,
            "line_end": 493
          },
          {
            "file": "SKILL.md",
            "line_start": 493,
            "line_end": 495
          },
          {
            "file": "SKILL.md",
            "line_start": 495,
            "line_end": 497
          },
          {
            "file": "SKILL.md",
            "line_start": 497,
            "line_end": 505
          },
          {
            "file": "SKILL.md",
            "line_start": 505,
            "line_end": 516
          },
          {
            "file": "SKILL.md",
            "line_start": 516,
            "line_end": 520
          },
          {
            "file": "SKILL.md",
            "line_start": 520,
            "line_end": 526
          },
          {
            "file": "SKILL.md",
            "line_start": 526,
            "line_end": 530
          },
          {
            "file": "SKILL.md",
            "line_start": 530,
            "line_end": 548
          },
          {
            "file": "SKILL.md",
            "line_start": 548,
            "line_end": 552
          },
          {
            "file": "SKILL.md",
            "line_start": 552,
            "line_end": 557
          },
          {
            "file": "SKILL.md",
            "line_start": 557,
            "line_end": 561
          },
          {
            "file": "SKILL.md",
            "line_start": 561,
            "line_end": 573
          },
          {
            "file": "SKILL.md",
            "line_start": 573,
            "line_end": 575
          },
          {
            "file": "SKILL.md",
            "line_start": 575,
            "line_end": 585
          },
          {
            "file": "SKILL.md",
            "line_start": 585,
            "line_end": 592
          },
          {
            "file": "SKILL.md",
            "line_start": 592,
            "line_end": 596
          },
          {
            "file": "SKILL.md",
            "line_start": 596,
            "line_end": 598
          },
          {
            "file": "SKILL.md",
            "line_start": 598,
            "line_end": 602
          },
          {
            "file": "SKILL.md",
            "line_start": 602,
            "line_end": 606
          },
          {
            "file": "SKILL.md",
            "line_start": 606,
            "line_end": 612
          },
          {
            "file": "SKILL.md",
            "line_start": 612,
            "line_end": 619
          },
          {
            "file": "SKILL.md",
            "line_start": 619,
            "line_end": 625
          },
          {
            "file": "SKILL.md",
            "line_start": 625,
            "line_end": 632
          },
          {
            "file": "SKILL.md",
            "line_start": 632,
            "line_end": 636
          },
          {
            "file": "SKILL.md",
            "line_start": 636,
            "line_end": 641
          },
          {
            "file": "SKILL.md",
            "line_start": 641,
            "line_end": 649
          },
          {
            "file": "SKILL.md",
            "line_start": 649,
            "line_end": 681
          },
          {
            "file": "SKILL.md",
            "line_start": 681,
            "line_end": 692
          },
          {
            "file": "SKILL.md",
            "line_start": 692,
            "line_end": 698
          },
          {
            "file": "SKILL.md",
            "line_start": 698,
            "line_end": 702
          },
          {
            "file": "SKILL.md",
            "line_start": 702,
            "line_end": 709
          },
          {
            "file": "SKILL.md",
            "line_start": 709,
            "line_end": 713
          },
          {
            "file": "SKILL.md",
            "line_start": 713,
            "line_end": 718
          },
          {
            "file": "SKILL.md",
            "line_start": 718,
            "line_end": 724
          },
          {
            "file": "SKILL.md",
            "line_start": 724,
            "line_end": 736
          },
          {
            "file": "SKILL.md",
            "line_start": 736,
            "line_end": 740
          },
          {
            "file": "SKILL.md",
            "line_start": 740,
            "line_end": 746
          },
          {
            "file": "SKILL.md",
            "line_start": 746,
            "line_end": 750
          },
          {
            "file": "SKILL.md",
            "line_start": 750,
            "line_end": 757
          },
          {
            "file": "SKILL.md",
            "line_start": 757,
            "line_end": 761
          },
          {
            "file": "SKILL.md",
            "line_start": 761,
            "line_end": 770
          },
          {
            "file": "SKILL.md",
            "line_start": 770,
            "line_end": 774
          },
          {
            "file": "SKILL.md",
            "line_start": 774,
            "line_end": 793
          },
          {
            "file": "SKILL.md",
            "line_start": 793,
            "line_end": 799
          },
          {
            "file": "SKILL.md",
            "line_start": 799,
            "line_end": 800
          },
          {
            "file": "SKILL.md",
            "line_start": 800,
            "line_end": 805
          },
          {
            "file": "SKILL.md",
            "line_start": 805,
            "line_end": 805
          },
          {
            "file": "SKILL.md",
            "line_start": 806,
            "line_end": 807
          },
          {
            "file": "SKILL.md",
            "line_start": 807,
            "line_end": 811
          },
          {
            "file": "SKILL.md",
            "line_start": 811,
            "line_end": 812
          },
          {
            "file": "SKILL.md",
            "line_start": 812,
            "line_end": 816
          },
          {
            "file": "SKILL.md",
            "line_start": 816,
            "line_end": 821
          },
          {
            "file": "SKILL.md",
            "line_start": 821,
            "line_end": 821
          },
          {
            "file": "SKILL.md",
            "line_start": 822,
            "line_end": 822
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "scripts:references/api-operations.md:271:dynamic-code-evaluation-with-eval",
        "category": "scripts",
        "severity": "high",
        "pattern": "Dynamic code evaluation with eval()",
        "file": "references/api-operations.md",
        "line_start": 271,
        "line_end": 271,
        "snippet": "query_embedding = text_to_embedding.eval(\"search query text\")"
      },
      {
        "id": "scripts:references/api-operations.md:302:dynamic-code-evaluation-with-eval",
        "category": "scripts",
        "severity": "high",
        "pattern": "Dynamic code evaluation with eval()",
        "file": "references/api-operations.md",
        "line_start": 302,
        "line_end": 302,
        "snippet": "query_vector = text_to_embedding.eval(query)"
      },
      {
        "id": "scripts:references/api-operations.md:360:dynamic-code-evaluation-with-eval",
        "category": "scripts",
        "severity": "high",
        "pattern": "Dynamic code evaluation with eval()",
        "file": "references/api-operations.md",
        "line_start": 360,
        "line_end": 360,
        "snippet": "query_embedding = text_to_embedding.eval(query)"
      },
      {
        "id": "network:references/api-operations.md:348:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/api-operations.md",
        "line_start": 348,
        "line_end": 348,
        "snippet": "return QdrantClient(url=\"http://localhost:6334\", prefer_grpc=True)"
      },
      {
        "id": "env_access:references/api-operations.md:286:python-environment-access",
        "category": "env_access",
        "severity": "low",
        "pattern": "Python environment access",
        "file": "references/api-operations.md",
        "line_start": 286,
        "line_end": 286,
        "snippet": "return ConnectionPool(os.environ[\"COCOINDEX_DATABASE_URL\"])"
      },
      {
        "id": "env_access:references/api-operations.md:24:dotenv-library",
        "category": "env_access",
        "severity": "low",
        "pattern": "dotenv library",
        "file": "references/api-operations.md",
        "line_start": 24,
        "line_end": 24,
        "snippet": "from dotenv import load_dotenv"
      },
      {
        "id": "env_access:references/api-operations.md:28:dotenv-library",
        "category": "env_access",
        "severity": "low",
        "pattern": "dotenv library",
        "file": "references/api-operations.md",
        "line_start": 28,
        "line_end": 28,
        "snippet": "load_dotenv()"
      },
      {
        "id": "env_access:references/api-operations.md:390:dotenv-library",
        "category": "env_access",
        "severity": "low",
        "pattern": "dotenv library",
        "file": "references/api-operations.md",
        "line_start": 390,
        "line_end": 390,
        "snippet": "from dotenv import load_dotenv"
      },
      {
        "id": "env_access:references/api-operations.md:394:dotenv-library",
        "category": "env_access",
        "severity": "low",
        "pattern": "dotenv library",
        "file": "references/api-operations.md",
        "line_start": 394,
        "line_end": 394,
        "snippet": "load_dotenv()"
      },
      {
        "id": "env_access:references/api-operations.md:426:dotenv-library",
        "category": "env_access",
        "severity": "low",
        "pattern": "dotenv library",
        "file": "references/api-operations.md",
        "line_start": 426,
        "line_end": 426,
        "snippet": "from dotenv import load_dotenv"
      },
      {
        "id": "env_access:references/api-operations.md:428:dotenv-library",
        "category": "env_access",
        "severity": "low",
        "pattern": "dotenv library",
        "file": "references/api-operations.md",
        "line_start": 428,
        "line_end": 428,
        "snippet": "load_dotenv()"
      },
      {
        "id": "env_access:references/api-operations.md:474:dotenv-library",
        "category": "env_access",
        "severity": "low",
        "pattern": "dotenv library",
        "file": "references/api-operations.md",
        "line_start": 474,
        "line_end": 474,
        "snippet": "from dotenv import load_dotenv"
      },
      {
        "id": "env_access:references/api-operations.md:476:dotenv-library",
        "category": "env_access",
        "severity": "low",
        "pattern": "dotenv library",
        "file": "references/api-operations.md",
        "line_start": 476,
        "line_end": 476,
        "snippet": "load_dotenv()"
      },
      {
        "id": "env_access:references/api-operations.md:575:dotenv-library",
        "category": "env_access",
        "severity": "low",
        "pattern": "dotenv library",
        "file": "references/api-operations.md",
        "line_start": 575,
        "line_end": 575,
        "snippet": "2. **Load environment variables** - Use dotenv or similar to load configuration"
      },
      {
        "id": "env_access:references/api-operations.md:24:python-dotenv-loader",
        "category": "env_access",
        "severity": "low",
        "pattern": "Python dotenv loader",
        "file": "references/api-operations.md",
        "line_start": 24,
        "line_end": 24,
        "snippet": "from dotenv import load_dotenv"
      },
      {
        "id": "env_access:references/api-operations.md:28:python-dotenv-loader",
        "category": "env_access",
        "severity": "low",
        "pattern": "Python dotenv loader",
        "file": "references/api-operations.md",
        "line_start": 28,
        "line_end": 28,
        "snippet": "load_dotenv()"
      },
      {
        "id": "env_access:references/api-operations.md:390:python-dotenv-loader",
        "category": "env_access",
        "severity": "low",
        "pattern": "Python dotenv loader",
        "file": "references/api-operations.md",
        "line_start": 390,
        "line_end": 390,
        "snippet": "from dotenv import load_dotenv"
      },
      {
        "id": "env_access:references/api-operations.md:394:python-dotenv-loader",
        "category": "env_access",
        "severity": "low",
        "pattern": "Python dotenv loader",
        "file": "references/api-operations.md",
        "line_start": 394,
        "line_end": 394,
        "snippet": "load_dotenv()"
      },
      {
        "id": "env_access:references/api-operations.md:426:python-dotenv-loader",
        "category": "env_access",
        "severity": "low",
        "pattern": "Python dotenv loader",
        "file": "references/api-operations.md",
        "line_start": 426,
        "line_end": 426,
        "snippet": "from dotenv import load_dotenv"
      },
      {
        "id": "env_access:references/api-operations.md:428:python-dotenv-loader",
        "category": "env_access",
        "severity": "low",
        "pattern": "Python dotenv loader",
        "file": "references/api-operations.md",
        "line_start": 428,
        "line_end": 428,
        "snippet": "load_dotenv()"
      },
      {
        "id": "env_access:references/api-operations.md:474:python-dotenv-loader",
        "category": "env_access",
        "severity": "low",
        "pattern": "Python dotenv loader",
        "file": "references/api-operations.md",
        "line_start": 474,
        "line_end": 474,
        "snippet": "from dotenv import load_dotenv"
      },
      {
        "id": "env_access:references/api-operations.md:476:python-dotenv-loader",
        "category": "env_access",
        "severity": "low",
        "pattern": "Python dotenv loader",
        "file": "references/api-operations.md",
        "line_start": 476,
        "line_end": 476,
        "snippet": "load_dotenv()"
      },
      {
        "id": "env_access:references/api-operations.md:286:database-connection-strings",
        "category": "env_access",
        "severity": "high",
        "pattern": "Database connection strings",
        "file": "references/api-operations.md",
        "line_start": 286,
        "line_end": 286,
        "snippet": "return ConnectionPool(os.environ[\"COCOINDEX_DATABASE_URL\"])"
      },
      {
        "id": "blocker:references/api-operations.md:90:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/api-operations.md",
        "line_start": 90,
        "line_end": 90,
        "snippet": "**Note:** After dropping, the Flow object is still valid and can be setup again."
      },
      {
        "id": "blocker:references/api-operations.md:105:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/api-operations.md",
        "line_start": 105,
        "line_end": 105,
        "snippet": "# After this, my_flow is invalid and should not be used"
      },
      {
        "id": "filesystem:references/cli-operations.md:49:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/cli-operations.md",
        "line_start": 49,
        "line_end": 49,
        "snippet": "cocoindex --env-file path/to/.env <command> ..."
      },
      {
        "id": "filesystem:references/cli-operations.md:352:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/cli-operations.md",
        "line_start": 352,
        "line_end": 352,
        "snippet": "cocoindex --env-file /path/to/.env update main.py"
      },
      {
        "id": "env_access:references/cli-operations.md:27:database-connection-strings",
        "category": "env_access",
        "severity": "high",
        "pattern": "Database connection strings",
        "file": "references/cli-operations.md",
        "line_start": 27,
        "line_end": 27,
        "snippet": "COCOINDEX_DATABASE_URL=postgresql://user:password@localhost/cocoindex_db"
      },
      {
        "id": "env_access:references/cli-operations.md:346:database-connection-strings",
        "category": "env_access",
        "severity": "high",
        "pattern": "Database connection strings",
        "file": "references/cli-operations.md",
        "line_start": 346,
        "line_end": 346,
        "snippet": "cat .env | grep COCOINDEX_DATABASE_URL"
      },
      {
        "id": "env_access:references/cli-operations.md:349:database-connection-strings",
        "category": "env_access",
        "severity": "high",
        "pattern": "Database connection strings",
        "file": "references/cli-operations.md",
        "line_start": 349,
        "line_end": 349,
        "snippet": "psql $COCOINDEX_DATABASE_URL"
      },
      {
        "id": "env_access:references/cli-operations.md:37:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "references/cli-operations.md",
        "line_start": 37,
        "line_end": 37,
        "snippet": "OPENAI_API_KEY=sk-..."
      },
      {
        "id": "env_access:references/cli-operations.md:38:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "references/cli-operations.md",
        "line_start": 38,
        "line_end": 38,
        "snippet": "ANTHROPIC_API_KEY=sk-ant-..."
      },
      {
        "id": "env_access:references/cli-operations.md:39:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "references/cli-operations.md",
        "line_start": 39,
        "line_end": 39,
        "snippet": "VOYAGE_API_KEY=pa-..."
      },
      {
        "id": "sensitive:references/cli-operations.md:23:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "references/cli-operations.md",
        "line_start": 23,
        "line_end": 23,
        "snippet": "Create a `.env` file in the project directory:"
      },
      {
        "id": "sensitive:references/cli-operations.md:45:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "references/cli-operations.md",
        "line_start": 45,
        "line_end": 45,
        "snippet": "# Default: loads .env from current directory"
      },
      {
        "id": "sensitive:references/cli-operations.md:49:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "references/cli-operations.md",
        "line_start": 49,
        "line_end": 49,
        "snippet": "cocoindex --env-file path/to/.env <command> ..."
      },
      {
        "id": "sensitive:references/cli-operations.md:345:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "references/cli-operations.md",
        "line_start": 345,
        "line_end": 345,
        "snippet": "# Check .env file exists"
      },
      {
        "id": "sensitive:references/cli-operations.md:346:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "references/cli-operations.md",
        "line_start": 346,
        "line_end": 346,
        "snippet": "cat .env | grep COCOINDEX_DATABASE_URL"
      },
      {
        "id": "sensitive:references/cli-operations.md:351:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "references/cli-operations.md",
        "line_start": 351,
        "line_end": 351,
        "snippet": "# Use --env-file if .env is elsewhere"
      },
      {
        "id": "sensitive:references/cli-operations.md:352:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "references/cli-operations.md",
        "line_start": 352,
        "line_end": 352,
        "snippet": "cocoindex --env-file /path/to/.env update main.py"
      },
      {
        "id": "sensitive:references/cli-operations.md:399:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "references/cli-operations.md",
        "line_start": 399,
        "line_end": 399,
        "snippet": "cocoindex --env-file prod.env update main"
      },
      {
        "id": "sensitive:references/cli-operations.md:407:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "references/cli-operations.md",
        "line_start": 407,
        "line_end": 407,
        "snippet": "# In .env file"
      },
      {
        "id": "sensitive:references/cli-operations.md:429:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "references/cli-operations.md",
        "line_start": 429,
        "line_end": 429,
        "snippet": "6. **Version control .env.example** - Document required environment variables"
      },
      {
        "id": "network:references/custom-functions.md:427:python-http-libraries",
        "category": "network",
        "severity": "low",
        "pattern": "Python HTTP libraries",
        "file": "references/custom-functions.md",
        "line_start": 427,
        "line_end": 427,
        "snippet": "response = requests.get("
      },
      {
        "id": "env_access:references/custom-functions.md:397:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "references/custom-functions.md",
        "line_start": 397,
        "line_end": 397,
        "snippet": "self.client = OpenAI()  # Uses OPENAI_API_KEY env var"
      },
      {
        "id": "env_access:references/custom-functions.md:420:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "references/custom-functions.md",
        "line_start": 420,
        "line_end": 420,
        "snippet": "api_key: str"
      },
      {
        "id": "env_access:references/custom-functions.md:429:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "references/custom-functions.md",
        "line_start": 429,
        "line_end": 429,
        "snippet": "headers={\"Authorization\": f\"Bearer {self.spec.api_key}\"}"
      },
      {
        "id": "blocker:references/custom-functions.md:485:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/custom-functions.md",
        "line_start": 485,
        "line_end": 485,
        "snippet": "7. **Handle errors gracefully** - Consider edge cases and invalid inputs"
      },
      {
        "id": "scripts:references/flow-patterns.md:338:dynamic-code-evaluation-with-eval",
        "category": "scripts",
        "severity": "high",
        "pattern": "Dynamic code evaluation with eval()",
        "file": "references/flow-patterns.md",
        "line_start": 338,
        "line_end": 338,
        "snippet": "query_embedding = text_to_embedding.eval(query)  # Evaluate with input"
      },
      {
        "id": "scripts:SKILL.md:572:dynamic-code-evaluation-with-eval",
        "category": "scripts",
        "severity": "high",
        "pattern": "Dynamic code evaluation with eval()",
        "file": "SKILL.md",
        "line_start": 572,
        "line_end": 572,
        "snippet": "query_embedding = text_to_embedding.eval(\"search query\")"
      },
      {
        "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": 81,
        "snippet": "- `cocoindex` - Core functionality, CLI, and most built-in functions"
      },
      {
        "id": "external_commands:SKILL.md:85:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 85,
        "line_end": 85,
        "snippet": "- `cocoindex[embeddings]` - For SentenceTransformer embeddings (when using `SentenceTransformerEmbed"
      },
      {
        "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": 86,
        "snippet": "- `cocoindex[colpali]` - For ColPali image/document embeddings (when using `ColPaliEmbedImage` or `C"
      },
      {
        "id": "external_commands:SKILL.md:87:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 87,
        "line_end": 87,
        "snippet": "- `cocoindex[lancedb]` - For LanceDB target (when exporting to LanceDB)"
      },
      {
        "id": "external_commands:SKILL.md:88:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 88,
        "line_end": 88,
        "snippet": "- `cocoindex[embeddings,lancedb]` - Multiple extras can be combined"
      },
      {
        "id": "external_commands:SKILL.md:93:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 93,
        "line_end": 93,
        "snippet": "- `embeddings` extra: SentenceTransformers library for local embedding models"
      },
      {
        "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": 94,
        "snippet": "- `colpali` extra: ColPali engine for multimodal document/image embeddings"
      },
      {
        "id": "external_commands:SKILL.md:95:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 95,
        "line_end": 95,
        "snippet": "- `lancedb` extra: LanceDB client library for LanceDB vector database support"
      },
      {
        "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": 97,
        "snippet": "Users can install using their preferred package manager (pip, uv, poetry, etc.) or add to `pyproject"
      },
      {
        "id": "external_commands:SKILL.md:105:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 105,
        "line_end": 105,
        "snippet": "1. Check if `COCOINDEX_DATABASE_URL` exists in environment variables"
      },
      {
        "id": "external_commands:SKILL.md:106:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 106,
        "line_end": 106,
        "snippet": "- If not found, use default: `postgres://cocoindex:cocoindex@localhost/cocoindex`"
      },
      {
        "id": "external_commands:SKILL.md:119:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 119,
        "line_end": 119,
        "snippet": "**Guide user to create `.env` file:**"
      },
      {
        "id": "external_commands:SKILL.md:121:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 121,
        "line_end": 131,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:131:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 131,
        "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": 151,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:151:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 151,
        "line_end": 157,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:157:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 157,
        "line_end": 196,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:196:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 196,
        "line_end": 201,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:201:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 201,
        "line_end": 202,
        "snippet": "- Use `.row()` to iterate through table data"
      },
      {
        "id": "external_commands:SKILL.md:202:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 202,
        "line_end": 202,
        "snippet": "- **CRITICAL: Always assign transformed data to row fields** - Use `item[\"new_field\"] = item[\"existi"
      },
      {
        "id": "external_commands:SKILL.md:211:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 211,
        "line_end": 215,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:215:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 215,
        "line_end": 219,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:219:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 219,
        "line_end": 223,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:223:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 223,
        "line_end": 227,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:227:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 227,
        "line_end": 237,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:237:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 237,
        "line_end": 250,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:250:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 250,
        "line_end": 252,
        "snippet": "**For text embedding:** Load `references/flow_patterns.md` and refer to \"Pattern 1: Simple Text Embe"
      },
      {
        "id": "external_commands:SKILL.md:252:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 252,
        "line_end": 254,
        "snippet": "**For code embedding:** Load `references/flow_patterns.md` and refer to \"Pattern 2: Code Embedding w"
      },
      {
        "id": "external_commands:SKILL.md:254:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 254,
        "line_end": 256,
        "snippet": "**For LLM extraction + knowledge graph:** Load `references/flow_patterns.md` and refer to \"Pattern 3"
      },
      {
        "id": "external_commands:SKILL.md:256:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 256,
        "line_end": 258,
        "snippet": "**For live updates:** Load `references/flow_patterns.md` and refer to \"Pattern 4: Live Updates with "
      },
      {
        "id": "external_commands:SKILL.md:258:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 258,
        "line_end": 260,
        "snippet": "**For custom functions:** Load `references/flow_patterns.md` and refer to \"Pattern 5: Custom Transfo"
      },
      {
        "id": "external_commands:SKILL.md:260:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 260,
        "line_end": 262,
        "snippet": "**For reusable query logic:** Load `references/flow_patterns.md` and refer to \"Pattern 6: Transform "
      },
      {
        "id": "external_commands:SKILL.md:262:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 262,
        "line_end": 279,
        "snippet": "**For concurrency control:** Load `references/flow_patterns.md` and refer to \"Pattern 7: Concurrency"
      },
      {
        "id": "external_commands:SKILL.md:279:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 279,
        "line_end": 288,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:288:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 288,
        "line_end": 303,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:303:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 303,
        "line_end": 303,
        "snippet": "- **Arguments of custom functions**: Relaxed - can use `Any`, `dict[str, Any]`, or omit annotations;"
      },
      {
        "id": "external_commands:SKILL.md:310:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 310,
        "line_end": 310,
        "snippet": "1. **Primitive types**: `str`, `int`, `float`, `bool`, `bytes`, `datetime.date`, `datetime.datetime`"
      },
      {
        "id": "external_commands:SKILL.md:313:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 313,
        "line_end": 314,
        "snippet": "- `cocoindex.Vector[cocoindex.Float32, typing.Literal[768]]` - 768-dim float32 vector (recommended)"
      },
      {
        "id": "external_commands:SKILL.md:314:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 314,
        "line_end": 317,
        "snippet": "- `list[float]` without dimension also works"
      },
      {
        "id": "external_commands:SKILL.md:317:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 317,
        "line_end": 318,
        "snippet": "- Return type: Must use specific class (e.g., `Person`)"
      },
      {
        "id": "external_commands:SKILL.md:318:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 318,
        "line_end": 318,
        "snippet": "- Argument: Can use `dict[str, Any]` or `Any`"
      },
      {
        "id": "external_commands:SKILL.md:321:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 321,
        "line_end": 322,
        "snippet": "- **KTable** (keyed): `dict[K, V]` where K = key type (primitive or frozen struct), V = Struct type"
      },
      {
        "id": "external_commands:SKILL.md:322:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 322,
        "line_end": 323,
        "snippet": "- **LTable** (ordered): `list[R]` where R = Struct type"
      },
      {
        "id": "external_commands:SKILL.md:323:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 323,
        "line_end": 323,
        "snippet": "- Arguments: Can use `dict[Any, Any]` or `list[Any]`"
      },
      {
        "id": "external_commands:SKILL.md:325:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 325,
        "line_end": 327,
        "snippet": "5. **Json type**: `cocoindex.Json` for unstructured/dynamic data"
      },
      {
        "id": "external_commands:SKILL.md:327:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 327,
        "line_end": 331,
        "snippet": "6. **Optional types**: `T | None` for nullable values"
      },
      {
        "id": "external_commands:SKILL.md:331:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 331,
        "line_end": 364,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:364:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 364,
        "line_end": 388,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:388:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 388,
        "line_end": 400,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:400:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 400,
        "line_end": 404,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:404:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 404,
        "line_end": 406,
        "snippet": "- Decorator: `@cocoindex.op.function()`"
      },
      {
        "id": "external_commands:SKILL.md:406:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 406,
        "line_end": 406,
        "snippet": "- Optional parameters: `cache=True` for expensive ops, `behavior_version` (required with cache)"
      },
      {
        "id": "external_commands:SKILL.md:410:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 410,
        "line_end": 434,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:434:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 434,
        "line_end": 443,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:443:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 443,
        "line_end": 445,
        "snippet": "**Important:** Increment `behavior_version` when function logic changes to invalidate cache."
      },
      {
        "id": "external_commands:SKILL.md:445:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 445,
        "line_end": 455,
        "snippet": "For detailed examples and patterns, load `references/custom_functions.md`."
      },
      {
        "id": "external_commands:SKILL.md:455:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 455,
        "line_end": 457,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:457:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 457,
        "line_end": 461,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:461:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 461,
        "line_end": 469,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:469:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 469,
        "line_end": 473,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:473:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 473,
        "line_end": 477,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:477:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 477,
        "line_end": 481,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:481:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 481,
        "line_end": 483,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:483:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 483,
        "line_end": 487,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:487:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 487,
        "line_end": 489,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:489:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 489,
        "line_end": 493,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:493:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 493,
        "line_end": 495,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:495:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 495,
        "line_end": 497,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:497:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 497,
        "line_end": 505,
        "snippet": "For complete CLI reference, load `references/cli_operations.md`."
      },
      {
        "id": "external_commands:SKILL.md:505:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 505,
        "line_end": 516,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:516:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 516,
        "line_end": 520,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:520:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 520,
        "line_end": 526,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:526:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 526,
        "line_end": 530,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:530:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 530,
        "line_end": 548,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:548:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 548,
        "line_end": 552,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:552:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 552,
        "line_end": 557,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:557:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 557,
        "line_end": 561,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:561:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 561,
        "line_end": 573,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:573:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 573,
        "line_end": 575,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:575:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 575,
        "line_end": 585,
        "snippet": "For complete API reference and patterns, load `references/api_operations.md`."
      },
      {
        "id": "external_commands:SKILL.md:585:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 585,
        "line_end": 592,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:592:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 592,
        "line_end": 596,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:596:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 596,
        "line_end": 598,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:598:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 598,
        "line_end": 602,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:602:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 602,
        "line_end": 606,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:606:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 606,
        "line_end": 612,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:612:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 612,
        "line_end": 619,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:619:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 619,
        "line_end": 625,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:625:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 625,
        "line_end": 632,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:632:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 632,
        "line_end": 636,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:636:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 636,
        "line_end": 641,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:641:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 641,
        "line_end": 649,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:649:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 649,
        "line_end": 681,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:681:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 681,
        "line_end": 692,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:692:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 692,
        "line_end": 698,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:698:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 698,
        "line_end": 702,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:702:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 702,
        "line_end": 709,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:709:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 709,
        "line_end": 713,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:713:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 713,
        "line_end": 718,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:718:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 718,
        "line_end": 724,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:724:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 724,
        "line_end": 736,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:736:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 736,
        "line_end": 740,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:740:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 740,
        "line_end": 746,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:746:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 746,
        "line_end": 750,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:750:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 750,
        "line_end": 757,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:757:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 757,
        "line_end": 761,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:761:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 761,
        "line_end": 770,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:770:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 770,
        "line_end": 774,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:774:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 774,
        "line_end": 793,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:793:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 793,
        "line_end": 799,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:799:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 799,
        "line_end": 800,
        "snippet": "- Check APP_TARGET format: `cocoindex show main.py`"
      },
      {
        "id": "external_commands:SKILL.md:800:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 800,
        "line_end": 805,
        "snippet": "- Use `--app-dir` if not in project root"
      },
      {
        "id": "external_commands:SKILL.md:805:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 805,
        "line_end": 805,
        "snippet": "- Check `.env` has `COCOINDEX_DATABASE_URL`"
      },
      {
        "id": "external_commands:SKILL.md:806:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 806,
        "line_end": 807,
        "snippet": "- Test connection: `psql $COCOINDEX_DATABASE_URL`"
      },
      {
        "id": "external_commands:SKILL.md:807:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 807,
        "line_end": 811,
        "snippet": "- Use `--env-file` to specify custom location"
      },
      {
        "id": "external_commands:SKILL.md:811:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 811,
        "line_end": 812,
        "snippet": "- Re-run setup: `cocoindex setup main.py`"
      },
      {
        "id": "external_commands:SKILL.md:812:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 812,
        "line_end": 816,
        "snippet": "- Drop and recreate: `cocoindex drop main.py && cocoindex setup main.py`"
      },
      {
        "id": "external_commands:SKILL.md:816:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 816,
        "line_end": 821,
        "snippet": "- Add `refresh_interval` to source"
      },
      {
        "id": "external_commands:SKILL.md:821:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 821,
        "line_end": 821,
        "snippet": "- Add concurrency limits on sources: `max_inflight_rows`, `max_inflight_bytes`"
      },
      {
        "id": "external_commands:SKILL.md:822:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 822,
        "line_end": 822,
        "snippet": "- Set global limits in `.env`: `COCOINDEX_SOURCE_MAX_INFLIGHT_ROWS`"
      },
      {
        "id": "network:SKILL.md:36:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 36,
        "line_end": 36,
        "snippet": "**For detailed documentation:** <https://cocoindex.io/docs/>"
      },
      {
        "id": "network:SKILL.md:37:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 37,
        "line_end": 37,
        "snippet": "**Search documentation:** <https://cocoindex.io/docs/search?q=url%20encoded%20keyword>"
      },
      {
        "id": "network:SKILL.md:99:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 99,
        "line_end": 99,
        "snippet": "**For installation details:** <https://cocoindex.io/docs/getting_started/installation>"
      },
      {
        "id": "network:SKILL.md:133:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 133,
        "line_end": 133,
        "snippet": "**For more LLM options:** <https://cocoindex.io/docs/ai/llm>"
      },
      {
        "id": "network:SKILL.md:244:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 244,
        "line_end": 244,
        "snippet": "2. **Review additional examples** - See <https://github.com/cocoindex-io/cocoindex?tab=readme-ov-fil"
      },
      {
        "id": "network:SKILL.md:286:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 286,
        "line_end": 286,
        "snippet": "# Then open CocoInsight at https://cocoindex.io/cocoinsight"
      },
      {
        "id": "network:SKILL.md:366:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 366,
        "line_end": 366,
        "snippet": "**For comprehensive data types documentation:** <https://cocoindex.io/docs/core/data_types>"
      },
      {
        "id": "network:SKILL.md:447:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 447,
        "line_end": 447,
        "snippet": "**For more on custom functions:** <https://cocoindex.io/docs/custom_ops/custom_functions>"
      },
      {
        "id": "network:SKILL.md:499:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 499,
        "line_end": 499,
        "snippet": "**For CLI documentation:** <https://cocoindex.io/docs/core/cli>"
      },
      {
        "id": "network:SKILL.md:577:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 577,
        "line_end": 577,
        "snippet": "**For API documentation:** <https://cocoindex.io/docs/core/flow_methods>"
      },
      {
        "id": "network:SKILL.md:685:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 685,
        "line_end": 685,
        "snippet": "**Browse all sources:** <https://cocoindex.io/docs/sources/>"
      },
      {
        "id": "network:SKILL.md:686:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 686,
        "line_end": 686,
        "snippet": "**Browse all targets:** <https://cocoindex.io/docs/targets/>"
      },
      {
        "id": "network:SKILL.md:840:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 840,
        "line_end": 840,
        "snippet": "**For comprehensive documentation:** <https://cocoindex.io/docs/>"
      },
      {
        "id": "network:SKILL.md:841:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 841,
        "line_end": 841,
        "snippet": "**Search specific topics:** <https://cocoindex.io/docs/search?q=url%20encoded%20keyword>"
      },
      {
        "id": "env_access:SKILL.md:139:dotenv-library",
        "category": "env_access",
        "severity": "low",
        "pattern": "dotenv library",
        "file": "SKILL.md",
        "line_start": 139,
        "line_end": 139,
        "snippet": "from dotenv import load_dotenv"
      },
      {
        "id": "env_access:SKILL.md:148:dotenv-library",
        "category": "env_access",
        "severity": "low",
        "pattern": "dotenv library",
        "file": "SKILL.md",
        "line_start": 148,
        "line_end": 148,
        "snippet": "load_dotenv()"
      },
      {
        "id": "env_access:SKILL.md:506:dotenv-library",
        "category": "env_access",
        "severity": "low",
        "pattern": "dotenv library",
        "file": "SKILL.md",
        "line_start": 506,
        "line_end": 506,
        "snippet": "from dotenv import load_dotenv"
      },
      {
        "id": "env_access:SKILL.md:509:dotenv-library",
        "category": "env_access",
        "severity": "low",
        "pattern": "dotenv library",
        "file": "SKILL.md",
        "line_start": 509,
        "line_end": 509,
        "snippet": "load_dotenv()"
      },
      {
        "id": "env_access:SKILL.md:139:python-dotenv-loader",
        "category": "env_access",
        "severity": "low",
        "pattern": "Python dotenv loader",
        "file": "SKILL.md",
        "line_start": 139,
        "line_end": 139,
        "snippet": "from dotenv import load_dotenv"
      },
      {
        "id": "env_access:SKILL.md:148:python-dotenv-loader",
        "category": "env_access",
        "severity": "low",
        "pattern": "Python dotenv loader",
        "file": "SKILL.md",
        "line_start": 148,
        "line_end": 148,
        "snippet": "load_dotenv()"
      },
      {
        "id": "env_access:SKILL.md:506:python-dotenv-loader",
        "category": "env_access",
        "severity": "low",
        "pattern": "Python dotenv loader",
        "file": "SKILL.md",
        "line_start": 506,
        "line_end": 506,
        "snippet": "from dotenv import load_dotenv"
      },
      {
        "id": "env_access:SKILL.md:509:python-dotenv-loader",
        "category": "env_access",
        "severity": "low",
        "pattern": "Python dotenv loader",
        "file": "SKILL.md",
        "line_start": 509,
        "line_end": 509,
        "snippet": "load_dotenv()"
      },
      {
        "id": "env_access:SKILL.md:105:database-connection-strings",
        "category": "env_access",
        "severity": "high",
        "pattern": "Database connection strings",
        "file": "SKILL.md",
        "line_start": 105,
        "line_end": 105,
        "snippet": "1. Check if `COCOINDEX_DATABASE_URL` exists in environment variables"
      },
      {
        "id": "env_access:SKILL.md:123:database-connection-strings",
        "category": "env_access",
        "severity": "high",
        "pattern": "Database connection strings",
        "file": "SKILL.md",
        "line_start": 123,
        "line_end": 123,
        "snippet": "COCOINDEX_DATABASE_URL=postgres://cocoindex:cocoindex@localhost/cocoindex"
      },
      {
        "id": "env_access:SKILL.md:805:database-connection-strings",
        "category": "env_access",
        "severity": "high",
        "pattern": "Database connection strings",
        "file": "SKILL.md",
        "line_start": 805,
        "line_end": 805,
        "snippet": "- Check `.env` has `COCOINDEX_DATABASE_URL`"
      },
      {
        "id": "env_access:SKILL.md:806:database-connection-strings",
        "category": "env_access",
        "severity": "high",
        "pattern": "Database connection strings",
        "file": "SKILL.md",
        "line_start": 806,
        "line_end": 806,
        "snippet": "- Test connection: `psql $COCOINDEX_DATABASE_URL`"
      },
      {
        "id": "env_access:SKILL.md:126:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "SKILL.md",
        "line_start": 126,
        "line_end": 126,
        "snippet": "OPENAI_API_KEY=sk-...          # For OpenAI (generation + embeddings)"
      },
      {
        "id": "env_access:SKILL.md:127:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "SKILL.md",
        "line_start": 127,
        "line_end": 127,
        "snippet": "ANTHROPIC_API_KEY=sk-ant-...   # For Anthropic (generation only)"
      },
      {
        "id": "env_access:SKILL.md:128:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "SKILL.md",
        "line_start": 128,
        "line_end": 128,
        "snippet": "GOOGLE_API_KEY=...             # For Gemini (generation + embeddings)"
      },
      {
        "id": "env_access:SKILL.md:129:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "SKILL.md",
        "line_start": 129,
        "line_end": 129,
        "snippet": "VOYAGE_API_KEY=pa-...          # For Voyage (embeddings only)"
      },
      {
        "id": "sensitive:SKILL.md:119:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "SKILL.md",
        "line_start": 119,
        "line_end": 119,
        "snippet": "**Guide user to create `.env` file:**"
      },
      {
        "id": "sensitive:SKILL.md:805:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "SKILL.md",
        "line_start": 805,
        "line_end": 805,
        "snippet": "- Check `.env` has `COCOINDEX_DATABASE_URL`"
      },
      {
        "id": "sensitive:SKILL.md:822:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "SKILL.md",
        "line_start": 822,
        "line_end": 822,
        "snippet": "- Set global limits in `.env`: `COCOINDEX_SOURCE_MAX_INFLIGHT_ROWS`"
      },
      {
        "id": "blocker:SKILL.md:360:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 360,
        "line_end": 360,
        "snippet": "# ❌ Wrong: dict[str, str] is not a valid specific CocoIndex type"
      }
    ],
    "finding_verdicts": [
      {
        "id": "scripts:references/api-operations.md:271:dynamic-code-evaluation-with-eval",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The flagged eval is CocoIndex transform_flow.eval() used in documentation to compute query embeddings. It is not Python built-in eval or arbitrary code execution."
      },
      {
        "id": "scripts:references/api-operations.md:302:dynamic-code-evaluation-with-eval",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The flagged eval is CocoIndex transform_flow.eval() used in documentation to compute query embeddings. It is not Python built-in eval or arbitrary code execution."
      },
      {
        "id": "scripts:references/api-operations.md:360:dynamic-code-evaluation-with-eval",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The flagged eval is CocoIndex transform_flow.eval() used in documentation to compute query embeddings. It is not Python built-in eval or arbitrary code execution."
      },
      {
        "id": "network:references/api-operations.md:348:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The URL is a localhost service endpoint in a Qdrant example. It does not indicate hidden outbound traffic or credential exfiltration."
      },
      {
        "id": "env_access:references/api-operations.md:286:python-environment-access",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "The sample reads a named CocoIndex database URL for a connection pool. It does not disclose the value outside the intended database client."
      },
      {
        "id": "env_access:references/api-operations.md:24:dotenv-library",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:references/api-operations.md:28:dotenv-library",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:references/api-operations.md:390:dotenv-library",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:references/api-operations.md:394:dotenv-library",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:references/api-operations.md:426:dotenv-library",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:references/api-operations.md:428:dotenv-library",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:references/api-operations.md:474:dotenv-library",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:references/api-operations.md:476:dotenv-library",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:references/api-operations.md:575:dotenv-library",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:references/api-operations.md:24:python-dotenv-loader",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:references/api-operations.md:28:python-dotenv-loader",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:references/api-operations.md:390:python-dotenv-loader",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:references/api-operations.md:394:python-dotenv-loader",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:references/api-operations.md:426:python-dotenv-loader",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:references/api-operations.md:428:python-dotenv-loader",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:references/api-operations.md:474:python-dotenv-loader",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:references/api-operations.md:476:python-dotenv-loader",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:references/api-operations.md:286:database-connection-strings",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "The line is a placeholder or expected CocoIndex database configuration example. It does not contain a real credential or unauthorized disclosure path."
      },
      {
        "id": "blocker:references/api-operations.md:90:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The matched text describes CocoIndex object lifecycle, error handling, or type examples. It does not request host, network, or system reconnaissance."
      },
      {
        "id": "blocker:references/api-operations.md:105:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The matched text describes CocoIndex object lifecycle, error handling, or type examples. It does not request host, network, or system reconnaissance."
      },
      {
        "id": "filesystem:references/cli-operations.md:49:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.82,
        "reason": "The line shows a user-specified --env-file option for the CocoIndex CLI. It is not unauthorized hidden file access."
      },
      {
        "id": "filesystem:references/cli-operations.md:352:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.82,
        "reason": "The line shows a user-specified --env-file option for the CocoIndex CLI. It is not unauthorized hidden file access."
      },
      {
        "id": "env_access:references/cli-operations.md:27:database-connection-strings",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "The line is a placeholder or expected CocoIndex database configuration example. It does not contain a real credential or unauthorized disclosure path."
      },
      {
        "id": "env_access:references/cli-operations.md:346:database-connection-strings",
        "verdict": "confirmed",
        "confidence": 0.86,
        "reason": "The troubleshooting command reads .env and prints the database URL line, which can expose credentials in terminal output or agent logs.",
        "severity": "high"
      },
      {
        "id": "env_access:references/cli-operations.md:349:database-connection-strings",
        "verdict": "confirmed",
        "confidence": 0.82,
        "reason": "Passing COCOINDEX_DATABASE_URL directly to psql can expand a password-bearing URL into process arguments. That may expose credentials on shared systems or logs.",
        "severity": "high"
      },
      {
        "id": "env_access:references/cli-operations.md:37:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "The detected values are placeholder API key examples or provider variable names. No real secret is present in the skill content."
      },
      {
        "id": "env_access:references/cli-operations.md:38:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "The detected values are placeholder API key examples or provider variable names. No real secret is present in the skill content."
      },
      {
        "id": "env_access:references/cli-operations.md:39:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "The detected values are placeholder API key examples or provider variable names. No real secret is present in the skill content."
      },
      {
        "id": "sensitive:references/cli-operations.md:23:environment-file-access",
        "verdict": "false_positive",
        "confidence": 0.83,
        "reason": "The line documents creating, loading, or referencing an env file for CocoIndex configuration. It does not read or expose hidden files without user intent."
      },
      {
        "id": "sensitive:references/cli-operations.md:45:environment-file-access",
        "verdict": "false_positive",
        "confidence": 0.83,
        "reason": "The line documents creating, loading, or referencing an env file for CocoIndex configuration. It does not read or expose hidden files without user intent."
      },
      {
        "id": "sensitive:references/cli-operations.md:49:environment-file-access",
        "verdict": "false_positive",
        "confidence": 0.83,
        "reason": "The line documents creating, loading, or referencing an env file for CocoIndex configuration. It does not read or expose hidden files without user intent."
      },
      {
        "id": "sensitive:references/cli-operations.md:345:environment-file-access",
        "verdict": "false_positive",
        "confidence": 0.83,
        "reason": "The line documents creating, loading, or referencing an env file for CocoIndex configuration. It does not read or expose hidden files without user intent."
      },
      {
        "id": "sensitive:references/cli-operations.md:346:environment-file-access",
        "verdict": "confirmed",
        "confidence": 0.88,
        "reason": "The command displays a sensitive .env entry containing the database connection URL. This can reveal credentials during troubleshooting.",
        "severity": "high"
      },
      {
        "id": "sensitive:references/cli-operations.md:351:environment-file-access",
        "verdict": "false_positive",
        "confidence": 0.83,
        "reason": "The line documents creating, loading, or referencing an env file for CocoIndex configuration. It does not read or expose hidden files without user intent."
      },
      {
        "id": "sensitive:references/cli-operations.md:352:environment-file-access",
        "verdict": "false_positive",
        "confidence": 0.83,
        "reason": "The line documents creating, loading, or referencing an env file for CocoIndex configuration. It does not read or expose hidden files without user intent."
      },
      {
        "id": "sensitive:references/cli-operations.md:399:environment-file-access",
        "verdict": "false_positive",
        "confidence": 0.83,
        "reason": "The line documents creating, loading, or referencing an env file for CocoIndex configuration. It does not read or expose hidden files without user intent."
      },
      {
        "id": "sensitive:references/cli-operations.md:407:environment-file-access",
        "verdict": "false_positive",
        "confidence": 0.83,
        "reason": "The line documents creating, loading, or referencing an env file for CocoIndex configuration. It does not read or expose hidden files without user intent."
      },
      {
        "id": "sensitive:references/cli-operations.md:429:environment-file-access",
        "verdict": "false_positive",
        "confidence": 0.83,
        "reason": "The line documents creating, loading, or referencing an env file for CocoIndex configuration. It does not read or expose hidden files without user intent."
      },
      {
        "id": "network:references/custom-functions.md:427:python-http-libraries",
        "verdict": "false_positive",
        "confidence": 0.7,
        "reason": "This is an example of a user-configured external API enrichment function. The line alone does not show a hidden destination or unauthorized exfiltration."
      },
      {
        "id": "env_access:references/custom-functions.md:397:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "The detected values are placeholder API key examples or provider variable names. No real secret is present in the skill content."
      },
      {
        "id": "env_access:references/custom-functions.md:420:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.68,
        "reason": "The line shows standard bearer authentication for a user-configured API example. It is not evidence that the skill sends secrets to an undisclosed endpoint."
      },
      {
        "id": "env_access:references/custom-functions.md:429:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.68,
        "reason": "The line shows standard bearer authentication for a user-configured API example. It is not evidence that the skill sends secrets to an undisclosed endpoint."
      },
      {
        "id": "blocker:references/custom-functions.md:485:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The matched text describes CocoIndex object lifecycle, error handling, or type examples. It does not request host, network, or system reconnaissance."
      },
      {
        "id": "scripts:references/flow-patterns.md:338:dynamic-code-evaluation-with-eval",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The flagged eval is CocoIndex transform_flow.eval() used in documentation to compute query embeddings. It is not Python built-in eval or arbitrary code execution."
      },
      {
        "id": "scripts:SKILL.md:572:dynamic-code-evaluation-with-eval",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The flagged eval is CocoIndex transform_flow.eval() used in documentation to compute query embeddings. It is not Python built-in eval or arbitrary code execution."
      },
      {
        "id": "external_commands:SKILL.md:81:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:85:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:86:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:87:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:88:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:93:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:94:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:95:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:97:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:105:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:106:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:119:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:121:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:131:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:137:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:151:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:157:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:196:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:201:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:202:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:211:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:215:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:219:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:223:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:227:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:237:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:250:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:252:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:254:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:256:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:258:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:260:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:262:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:279:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:288:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:303:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:310:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:313:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:314:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:317:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:318:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:321:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:322:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:323:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:325:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:327:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:331:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:364:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:388:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:400:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:404:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:406:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:410:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:434:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:443:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:445:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:455:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:457:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:461:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:469:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:473:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:477:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:481:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:483:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:487:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:489:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:493:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:495:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:497:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:505:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:516:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:520:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:526:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:530:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:548:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:552:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:557:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:561:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:573:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:575:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:585:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:592:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:596:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:598:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:602:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:606:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:612:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:619:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:625:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:632:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:636:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:641:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:649:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:681:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:692:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:698:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:702:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:709:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:713:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:718:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:724:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:736:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:740:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:746:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:750:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:757:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:761:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:770:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:774:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:793:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The scanner matched a Markdown code fence, not Ruby backtick execution. The skill file is documentation and this line does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:799:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:800:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:805:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:806:ruby-shell-backtick-execution",
        "verdict": "confirmed",
        "confidence": 0.78,
        "reason": "The inline command runs psql with a potentially secret database URL. The command is operationally useful but can expose credentials if executed by an agent.",
        "severity": "high"
      },
      {
        "id": "external_commands:SKILL.md:807:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:811:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:812:ruby-shell-backtick-execution",
        "verdict": "confirmed",
        "confidence": 0.78,
        "reason": "The inline command uses cocoindex drop before setup, which can remove flow resources. It should require explicit confirmation and a backup plan.",
        "severity": "medium"
      },
      {
        "id": "external_commands:SKILL.md:816:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:821:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "external_commands:SKILL.md:822:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The scanner matched Markdown inline code or API names, not Ruby shell execution. This line is documentation rather than executable skill code."
      },
      {
        "id": "network:SKILL.md:36:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "The URL is a visible CocoIndex documentation or product link in Markdown. It is not a hidden network call by the skill."
      },
      {
        "id": "network:SKILL.md:37:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "The URL is a visible CocoIndex documentation or product link in Markdown. It is not a hidden network call by the skill."
      },
      {
        "id": "network:SKILL.md:99:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "The URL is a visible CocoIndex documentation or product link in Markdown. It is not a hidden network call by the skill."
      },
      {
        "id": "network:SKILL.md:133:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "The URL is a visible CocoIndex documentation or product link in Markdown. It is not a hidden network call by the skill."
      },
      {
        "id": "network:SKILL.md:244:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "The URL is a visible CocoIndex documentation or product link in Markdown. It is not a hidden network call by the skill."
      },
      {
        "id": "network:SKILL.md:286:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "The URL is a visible CocoIndex documentation or product link in Markdown. It is not a hidden network call by the skill."
      },
      {
        "id": "network:SKILL.md:366:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "The URL is a visible CocoIndex documentation or product link in Markdown. It is not a hidden network call by the skill."
      },
      {
        "id": "network:SKILL.md:447:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "The URL is a visible CocoIndex documentation or product link in Markdown. It is not a hidden network call by the skill."
      },
      {
        "id": "network:SKILL.md:499:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "The URL is a visible CocoIndex documentation or product link in Markdown. It is not a hidden network call by the skill."
      },
      {
        "id": "network:SKILL.md:577:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "The URL is a visible CocoIndex documentation or product link in Markdown. It is not a hidden network call by the skill."
      },
      {
        "id": "network:SKILL.md:685:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "The URL is a visible CocoIndex documentation or product link in Markdown. It is not a hidden network call by the skill."
      },
      {
        "id": "network:SKILL.md:686:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "The URL is a visible CocoIndex documentation or product link in Markdown. It is not a hidden network call by the skill."
      },
      {
        "id": "network:SKILL.md:840:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "The URL is a visible CocoIndex documentation or product link in Markdown. It is not a hidden network call by the skill."
      },
      {
        "id": "network:SKILL.md:841:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.92,
        "reason": "The URL is a visible CocoIndex documentation or product link in Markdown. It is not a hidden network call by the skill."
      },
      {
        "id": "env_access:SKILL.md:139:dotenv-library",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:SKILL.md:148:dotenv-library",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:SKILL.md:506:dotenv-library",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:SKILL.md:509:dotenv-library",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:SKILL.md:139:python-dotenv-loader",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:SKILL.md:148:python-dotenv-loader",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:SKILL.md:506:python-dotenv-loader",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:SKILL.md:509:python-dotenv-loader",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The dotenv usage appears in setup examples to load local configuration. It does not print, transmit, or harvest secrets by itself."
      },
      {
        "id": "env_access:SKILL.md:105:database-connection-strings",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "The line is a placeholder or expected CocoIndex database configuration example. It does not contain a real credential or unauthorized disclosure path."
      },
      {
        "id": "env_access:SKILL.md:123:database-connection-strings",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "The line is a placeholder or expected CocoIndex database configuration example. It does not contain a real credential or unauthorized disclosure path."
      },
      {
        "id": "env_access:SKILL.md:805:database-connection-strings",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "The line is a placeholder or expected CocoIndex database configuration example. It does not contain a real credential or unauthorized disclosure path."
      },
      {
        "id": "env_access:SKILL.md:806:database-connection-strings",
        "verdict": "confirmed",
        "confidence": 0.82,
        "reason": "The troubleshooting guidance invokes psql with COCOINDEX_DATABASE_URL, which may include a database password. Shell expansion can expose the secret in process metadata.",
        "severity": "high"
      },
      {
        "id": "env_access:SKILL.md:126:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "The detected values are placeholder API key examples or provider variable names. No real secret is present in the skill content."
      },
      {
        "id": "env_access:SKILL.md:127:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "The detected values are placeholder API key examples or provider variable names. No real secret is present in the skill content."
      },
      {
        "id": "env_access:SKILL.md:128:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "The detected values are placeholder API key examples or provider variable names. No real secret is present in the skill content."
      },
      {
        "id": "env_access:SKILL.md:129:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "The detected values are placeholder API key examples or provider variable names. No real secret is present in the skill content."
      },
      {
        "id": "sensitive:SKILL.md:119:environment-file-access",
        "verdict": "false_positive",
        "confidence": 0.83,
        "reason": "The line documents creating, loading, or referencing an env file for CocoIndex configuration. It does not read or expose hidden files without user intent."
      },
      {
        "id": "sensitive:SKILL.md:805:environment-file-access",
        "verdict": "false_positive",
        "confidence": 0.83,
        "reason": "The line documents creating, loading, or referencing an env file for CocoIndex configuration. It does not read or expose hidden files without user intent."
      },
      {
        "id": "sensitive:SKILL.md:822:environment-file-access",
        "verdict": "false_positive",
        "confidence": 0.83,
        "reason": "The line documents creating, loading, or referencing an env file for CocoIndex configuration. It does not read or expose hidden files without user intent."
      },
      {
        "id": "blocker:SKILL.md:360:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The matched text describes CocoIndex object lifecycle, error handling, or type examples. It does not request host, network, or system reconnaissance."
      }
    ],
    "semantic_findings": [
      {
        "title": "Credential Collection Instruction",
        "description": "The skill instructs the assistant to ask the user to provide missing API key values and to avoid simplified examples without LLMs. This encourages disclosure of secrets in chat instead of safer environment setup guidance.",
        "severity": "high",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 115,
            "line_end": 117
          }
        ],
        "confidence": 0.91,
        "confidence_reasoning": "The cited lines directly tell the assistant to ask for an API key value when it is missing. That is a clear secret-handling risk in an agent marketplace skill."
      },
      {
        "title": "Destructive Operations Without Strong Confirmation",
        "description": "The skill includes commands that force setup without confirmation and remove or reset CocoIndex resources. These commands should be gated by explicit user confirmation and backup guidance.",
        "severity": "medium",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 279,
            "line_end": 282
          },
          {
            "file": "SKILL.md",
            "line_start": 467,
            "line_end": 482
          }
        ],
        "confidence": 0.78,
        "confidence_reasoning": "The cited examples include a force flag, reset language, and a drop command. They are legitimate CocoIndex operations, but unsafe if an agent runs them without confirmation."
      }
    ],
    "critical_findings": [],
    "high_findings": [
      {
        "title": "Database connection strings",
        "description": "cat .env | grep COCOINDEX_DATABASE_URL",
        "locations": [
          {
            "file": "references/cli-operations.md",
            "line_start": 346,
            "line_end": 346
          }
        ],
        "review_kind": "capability",
        "source_category": "env_access",
        "source_severity": "high",
        "confidence": 0.86,
        "confidence_reasoning": "The troubleshooting command reads .env and prints the database URL line, which can expose credentials in terminal output or agent logs."
      },
      {
        "title": "Database connection strings",
        "description": "psql $COCOINDEX_DATABASE_URL",
        "locations": [
          {
            "file": "references/cli-operations.md",
            "line_start": 349,
            "line_end": 349
          }
        ],
        "review_kind": "capability",
        "source_category": "env_access",
        "source_severity": "high",
        "confidence": 0.82,
        "confidence_reasoning": "Passing COCOINDEX_DATABASE_URL directly to psql can expand a password-bearing URL into process arguments. That may expose credentials on shared systems or logs."
      },
      {
        "title": "Environment file access",
        "description": "cat .env | grep COCOINDEX_DATABASE_URL",
        "locations": [
          {
            "file": "references/cli-operations.md",
            "line_start": 346,
            "line_end": 346
          }
        ],
        "review_kind": "security",
        "source_category": "sensitive",
        "source_severity": "high",
        "confidence": 0.88,
        "confidence_reasoning": "The command displays a sensitive .env entry containing the database connection URL. This can reveal credentials during troubleshooting."
      },
      {
        "title": "Ruby/shell backtick execution",
        "description": "- Test connection: `psql $COCOINDEX_DATABASE_URL`",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 806,
            "line_end": 807
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.78,
        "confidence_reasoning": "The inline command runs psql with a potentially secret database URL. The command is operationally useful but can expose credentials if executed by an agent."
      },
      {
        "title": "Database connection strings",
        "description": "- Test connection: `psql $COCOINDEX_DATABASE_URL`",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 806,
            "line_end": 806
          }
        ],
        "review_kind": "capability",
        "source_category": "env_access",
        "source_severity": "high",
        "confidence": 0.82,
        "confidence_reasoning": "The troubleshooting guidance invokes psql with COCOINDEX_DATABASE_URL, which may include a database password. Shell expansion can expose the secret in process metadata."
      },
      {
        "title": "Credential Collection Instruction",
        "description": "The skill instructs the assistant to ask the user to provide missing API key values and to avoid simplified examples without LLMs. This encourages disclosure of secrets in chat instead of safer environment setup guidance.",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 115,
            "line_end": 117
          }
        ],
        "review_kind": "security",
        "source_category": "semantic",
        "source_severity": "high",
        "confidence": 0.91,
        "confidence_reasoning": "The cited lines directly tell the assistant to ask for an API key value when it is missing. That is a clear secret-handling risk in an agent marketplace skill."
      }
    ],
    "medium_findings": [
      {
        "title": "Ruby/shell backtick execution",
        "description": "- Drop and recreate: `cocoindex drop main.py && cocoindex setup main.py`",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 812,
            "line_end": 816
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.78,
        "confidence_reasoning": "The inline command uses cocoindex drop before setup, which can remove flow resources. It should require explicit confirmation and a backup plan."
      },
      {
        "title": "Destructive Operations Without Strong Confirmation",
        "description": "The skill includes commands that force setup without confirmation and remove or reset CocoIndex resources. These commands should be gated by explicit user confirmation and backup guidance.",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 279,
            "line_end": 282
          },
          {
            "file": "SKILL.md",
            "line_start": 467,
            "line_end": 482
          }
        ],
        "review_kind": "security",
        "source_category": "semantic",
        "source_severity": "medium",
        "confidence": 0.78,
        "confidence_reasoning": "The cited examples include a force flag, reset language, and a drop command. They are legitimate CocoIndex operations, but unsafe if an agent runs them without confirmation."
      }
    ],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 5,
    "total_lines": 2833,
    "audit_model": "codex",
    "audited_at": "2026-07-05T11:19:52.681Z",
    "agent_auto_install_policy": "confirmation_required",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Build CocoIndex Data Pipelines",
    "value_statement": "AI data projects need reliable indexing flows, custom transforms, and operational commands. This skill guides CocoIndex design, implementation, testing, and troubleshooting.",
    "seo_keywords": [
      "CocoIndex",
      "Claude",
      "Codex",
      "Claude Code",
      "AI data pipelines",
      "vector search",
      "ETL workflows",
      "knowledge graph",
      "embedding pipelines",
      "custom functions"
    ],
    "actual_capabilities": [
      "Guides CocoIndex flow definitions with sources, collectors, transforms, and exports.",
      "Provides patterns for embeddings, knowledge graph extraction, live updates, and concurrency control.",
      "Explains custom functions, executor classes, type annotations, caching, and behavior versions.",
      "Shows CLI workflows for setup, update, evaluate, server mode, inspection, and troubleshooting.",
      "Covers Python API patterns for setup, live updates, query handlers, and application integration."
    ],
    "limitations": [
      "It does not validate live infrastructure unless the user provides tool access.",
      "Users must configure databases, storage permissions, and model provider credentials.",
      "Generated flows still need review for data safety, cost, and production readiness.",
      "Examples may need adjustment for future CocoIndex API changes."
    ],
    "use_cases": [
      {
        "title": "Create Document Vector Search",
        "description": "Design a flow that chunks documents, creates embeddings, and exports searchable vectors to a target database.",
        "target_user": "Data engineer"
      },
      {
        "title": "Extract Knowledge Graphs",
        "description": "Build an LLM extraction workflow that identifies entities and relationships from source documents.",
        "target_user": "Machine learning engineer"
      },
      {
        "title": "Operate Production Flows",
        "description": "Use CocoIndex CLI and API patterns to set up, update, inspect, and troubleshoot indexing workflows.",
        "target_user": "Backend developer"
      }
    ],
    "prompt_templates": [
      {
        "title": "Start a Basic Flow",
        "scenario": "Beginner setup for local documents and vector search.",
        "prompt": "Create a CocoIndex flow for local Markdown files that chunks text, embeds each chunk, and exports vectors to Postgres."
      },
      {
        "title": "Add a Custom Transform",
        "scenario": "Intermediate customization for reusable processing logic.",
        "prompt": "Help me add a typed CocoIndex custom function that cleans document text before embedding and explains where caching is useful."
      },
      {
        "title": "Design LLM Extraction",
        "scenario": "Advanced structured extraction and graph modeling.",
        "prompt": "Design a CocoIndex workflow that extracts entities and relationships from PDFs and exports them as a Neo4j knowledge graph."
      },
      {
        "title": "Plan Production Operations",
        "scenario": "Advanced deployment, monitoring, and troubleshooting workflow.",
        "prompt": "Review my CocoIndex flow plan for live updates, query handlers, concurrency limits, setup commands, and safe operational checks."
      }
    ],
    "output_examples": [
      {
        "input": "I need a vector search index for product manuals.",
        "output": "A flow plan with source selection, chunking strategy, embedding model choice, target schema, and test steps."
      },
      {
        "input": "My flow changed and the target schema no longer matches.",
        "output": "A troubleshooting checklist that reviews setup state, flow targets, schema changes, and safe validation steps."
      },
      {
        "input": "I want reusable logic for both indexing and search queries.",
        "output": "A transform flow design that reuses embedding logic and explains how query handlers should call it."
      }
    ],
    "best_practices": [
      "Confirm data sources, target stores, model providers, and update frequency before designing a flow.",
      "Use typed custom function returns so CocoIndex can infer schemas before processing data.",
      "Test with evaluate or non-production targets before running setup, reset, drop, or live updates."
    ],
    "anti_patterns": [
      "Do not ask users to paste secret values into chat when environment setup is enough.",
      "Do not run reset or drop commands without explicit user confirmation and a backup plan.",
      "Do not use local variables for transformed flow fields that must be collected or exported."
    ],
    "faq": [
      {
        "question": "What does this skill help build?",
        "answer": "It helps build CocoIndex flows for indexing, embeddings, extraction, search, and operational workflows."
      },
      {
        "question": "Can it generate complete CocoIndex code?",
        "answer": "Yes. It can guide complete flow code, but users should review generated code before running it."
      },
      {
        "question": "Does it require API keys?",
        "answer": "Only flows that use hosted LLM or embedding providers need API keys. Users should store keys outside chat."
      },
      {
        "question": "Which targets are covered?",
        "answer": "The skill covers Postgres, Qdrant, LanceDB, Neo4j, Kuzu, and related export patterns."
      },
      {
        "question": "Can it help with live updates?",
        "answer": "Yes. It explains live update patterns, refresh intervals, and source-specific change capture options."
      },
      {
        "question": "Is this skill safe for production operations?",
        "answer": "Use it with review. Confirm destructive commands, secret handling, and target environments before execution."
      }
    ]
  },
  "file_structure": [
    {
      "name": "references",
      "type": "dir",
      "path": "references",
      "children": [
        {
          "name": "api-operations.md",
          "type": "file",
          "path": "references/api-operations.md",
          "lines": 583
        },
        {
          "name": "cli-operations.md",
          "type": "file",
          "path": "references/cli-operations.md",
          "lines": 432
        },
        {
          "name": "custom-functions.md",
          "type": "file",
          "path": "references/custom-functions.md",
          "lines": 487
        },
        {
          "name": "flow-patterns.md",
          "type": "file",
          "path": "references/flow-patterns.md",
          "lines": 489
        }
      ]
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 842
    }
  ]
}
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall