{
  "ok": true,
  "resource": {
    "id": "RES_E41B7843016D",
    "resource_type": "skill",
    "canonical_url": "https://github.com/K-Dense-AI/scientific-agent-skills/tree/1e5eeffbdad3749125afe7ab48a39694e27f181c/skills/matchms",
    "name": "matchms",
    "summary_en": "Process, clean, compare, and search tandem mass spectra with matchms. Use for MS/MS file I/O, metadata harmonization, peak filtering, spectral similarity, library matching, score matrices, and molecular-similarity networks. Use pyopenms instead for LC-MS feature detection or proteomics pipelines.",
    "summary_zh": "使用matchms处理、清理、比较和搜索串联质谱。用于MS/MS文件I/O、元数据协调、峰过滤、谱相似性、库匹配、评分矩阵和分子相似性网络。对于LC-MS特征检测或蛋白质组学流程，请改用pyopenms。",
    "description_en": "This skill provides procedural guidance for using the matchms Python package (version 0.33.1) to process, clean, compare, and search tandem mass spectra. It covers file I/O for formats like MGF, MSP, mzML, mzXML, JSON, mzSpecLib, and metabolomics-USI; metadata harmonization; peak filtering; spectral similarity scoring (cosine, modified cosine, neutral loss, etc.); library matching; score matrices; and molecular-similarity networks. The skill includes code examples, API guardrails for matchms 0.33.1, and references to detailed documentation. It explicitly states that matchms is not for LC-MS feature detection or proteomics pipelines, recommending pyopenms for those tasks. The skill is part of the Scientific Agent Skills library by K-Dense and is licensed under Apache-2.0.",
    "description_zh": "该技能提供了使用matchms Python包（版本0.33.1）处理、清理、比较和搜索串联质谱的程序性指导。涵盖MGF、MSP、mzML、mzXML、JSON、mzSpecLib和metabolomics-USI等格式的文件I/O；元数据协调；峰过滤；谱相似性评分（余弦、修正余弦、中性丢失等）；库匹配；评分矩阵；以及分子相似性网络。技能包含代码示例、matchms 0.33.1的API防护指南和详细文档的引用。它明确指出matchms不用于LC-MS特征检测或蛋白质组学流程，建议这些任务使用pyopenms。该技能是K-Dense的Scientific Agent Skills库的一部分，采用Apache-2.0许可。",
    "provider_name": "K-Dense-AI",
    "homepage_url": "https://github.com/K-Dense-AI/scientific-agent-skills/tree/main/skills/matchms",
    "endpoint_url": null,
    "source_url": "https://raw.githubusercontent.com/K-Dense-AI/scientific-agent-skills/1e5eeffbdad3749125afe7ab48a39694e27f181c/skills/matchms/SKILL.md",
    "icon_url": null,
    "cover_image_url": null,
    "capabilities": [
      "data.analyze",
      "data.transform",
      "data.search"
    ],
    "categories": [
      "research",
      "data"
    ],
    "industries": [
      "health",
      "software"
    ],
    "protocols": [
      "agent-skills"
    ],
    "auth": {
      "type": "none",
      "required": false
    },
    "pricing": {
      "model": "free"
    },
    "input_schema": {},
    "output_schema": {},
    "metadata": {
      "content_language": "en",
      "translation_status": "original-only",
      "license": {
        "spdx_id": "Apache-2.0",
        "source": "https://github.com/K-Dense-AI/scientific-agent-skills/blob/1e5eeffbdad3749125afe7ab48a39694e27f181c/LICENSE"
      },
      "github": {
        "repository": "K-Dense-AI/scientific-agent-skills",
        "owner": "K-Dense-AI",
        "path": "skills/matchms/SKILL.md",
        "commit": "1e5eeffbdad3749125afe7ab48a39694e27f181c",
        "stars": 42124,
        "forks": 3870,
        "updated_at": "2026-09-03T02:47:03Z"
      },
      "skill": {
        "compatibility": "Requires Python >=3.10,<3.15, uv, and matchms 0.33.1. Local file workflows need no credentials; metabolomics-USI loading requires network access.",
        "allowed_tools": "Read Write Edit Bash",
        "content_hash": "059f2bcca9e8cc822e295de13037931557fe805527c4aeb833519cd7bb1de9a8",
        "line_count": 293
      },
      "review_gate": {
        "passed": true,
        "reasons": [],
        "policy_version": "review-gate-v1",
        "evaluated_at": "2026-09-03T06:00:55.943Z"
      }
    },
    "latest_version": "1e5eeffbdad3",
    "status": "listed",
    "health_status": "unknown",
    "source_kind": "imported",
    "source_agent": "aiworkshub-skill-reviewer",
    "trust": {
      "signal": "none",
      "reason": "No suspicious or malicious evidence.",
      "signals": {
        "yellow": 0,
        "red": 0
      }
    },
    "review_summary": {
      "method_version": "capability-evidence-v2",
      "capability_definition": "strong",
      "contract_completeness": "strong",
      "access_friction": "low",
      "operational_transparency": "strong",
      "evidence_strength": "source_inspected",
      "use_readiness": "guided_use",
      "reviewed_at": "2026-09-03T06:00:56.877Z"
    },
    "experience_count": 0,
    "verified_experience_count": 0,
    "usage_count": 0,
    "success_rate": null,
    "first_seen_at": "2026-09-03T02:50:41.996Z",
    "last_seen_at": "2026-09-03T06:00:56.175Z",
    "published_at": "2026-09-03T06:00:56.175Z",
    "created_at": "2026-09-03T02:50:41.996Z",
    "updated_at": "2026-09-03T06:00:56.877Z",
    "api_url": "https://aiworkshub.io/api/v1/resources/RES_E41B7843016D",
    "reviews_url": "https://aiworkshub.io/api/v1/resources/RES_E41B7843016D/reviews",
    "public_url": "https://aiworkshub.io/resources/RES_E41B7843016D",
    "distribution": {
      "canonical_identity": "https://github.com/K-Dense-AI/scientific-agent-skills/tree/1e5eeffbdad3749125afe7ab48a39694e27f181c/skills/matchms",
      "syndicatable": true,
      "origins": [
        {
          "registry_url": "https://github.com/",
          "upstream_resource_id": "K-Dense-AI/scientific-agent-skills:skills/matchms/SKILL.md",
          "upstream_record_url": "https://github.com/K-Dense-AI/scientific-agent-skills/tree/1e5eeffbdad3749125afe7ab48a39694e27f181c/skills/matchms",
          "relation": "syndicated",
          "metadata": {
            "source": "github-skill-import"
          },
          "first_seen_at": "2026-09-03T02:50:41.996Z",
          "last_seen_at": "2026-09-03T06:00:56.175Z"
        }
      ]
    },
    "tools": [],
    "review_profile": {
      "schema_version": "aiworkshub.resource-review/0.2",
      "method_version": "capability-evidence-v2",
      "review_state": {
        "identity": "verified",
        "source": "verified",
        "connectivity": "unknown",
        "contract": "strong",
        "safe_use": "untested",
        "real_use": "unobserved"
      },
      "assessment": {
        "capability_definition": "strong",
        "contract_completeness": "strong",
        "access_friction": "low",
        "operational_transparency": "strong",
        "evidence_strength": "source_inspected",
        "use_readiness": "guided_use"
      },
      "profile": {
        "capabilities": [
          {
            "id": "data.analyze",
            "weight": 90,
            "confidence": 90,
            "evidence_ids": [
              "source-record",
              "source-inspection"
            ]
          },
          {
            "id": "data.transform",
            "weight": 80,
            "confidence": 90,
            "evidence_ids": [
              "source-record",
              "source-inspection"
            ]
          },
          {
            "id": "data.search",
            "weight": 70,
            "confidence": 90,
            "evidence_ids": [
              "source-record",
              "source-inspection"
            ]
          }
        ],
        "domains": [
          {
            "id": "scientific-research",
            "weight": 90,
            "confidence": 90,
            "evidence_ids": [
              "source-record"
            ]
          },
          {
            "id": "data-analysis",
            "weight": 90,
            "confidence": 90,
            "evidence_ids": [
              "source-record"
            ]
          },
          {
            "id": "software-development",
            "weight": 60,
            "confidence": 90,
            "evidence_ids": [
              "source-record"
            ]
          }
        ],
        "workflow_roles": [
          "analyze",
          "transform",
          "retrieve"
        ]
      },
      "capability_units": [
        {
          "id": "skill:matchms",
          "kind": "skill_action",
          "capability_id": "data.analyze",
          "effect": "compute",
          "open_world": false,
          "idempotency": "idempotent",
          "confirmation": "explicit policy",
          "input_contract": "natural_language",
          "output_contract": "natural_language",
          "accepts": [
            "task context"
          ],
          "produces": [
            "task result"
          ],
          "runtime_auth": {},
          "pricing": {},
          "evidence_ids": [
            "source-inspection"
          ],
          "metadata": {}
        }
      ],
      "access": {
        "distribution_license": {
          "spdx_id": "Apache-2.0",
          "source": "https://github.com/K-Dense-AI/scientific-agent-skills/blob/1e5eeffbdad3749125afe7ab48a39694e27f181c/LICENSE"
        },
        "runtime_auth": {},
        "runtime_pricing": {},
        "dependencies": [
          "Python >=3.10,<3.15",
          "uv",
          "matchms 0.33.1"
        ]
      },
      "operational_flags": [],
      "trust": {
        "signal": "none",
        "evidence_ids": [],
        "reason": "No suspicious or malicious evidence."
      },
      "fit": {
        "good_for": [
          "Processing and cleaning tandem mass spectra",
          "Comparing spectra using similarity scores",
          "Searching spectral libraries",
          "Building molecular-similarity networks"
        ],
        "not_for": [
          "LC-MS feature detection",
          "Proteomics pipelines",
          "Vendor raw-file conversion",
          "Validated compound identification"
        ]
      },
      "evidence": [
        {
          "id": "source-record",
          "type": "source_record",
          "source": "https://raw.githubusercontent.com/K-Dense-AI/scientific-agent-skills/1e5eeffbdad3749125afe7ab48a39694e27f181c/skills/matchms/SKILL.md",
          "observation": "Submitted Skill record for matchms; declared license Apache-2.0.",
          "observed_at": "2026-09-03T02:47:03Z",
          "payload": {}
        },
        {
          "id": "source-inspection",
          "type": "source_inspection",
          "source": "https://raw.githubusercontent.com/K-Dense-AI/scientific-agent-skills/1e5eeffbdad3749125afe7ab48a39694e27f181c/skills/matchms/SKILL.md",
          "observation": "The Skill source was fetched and inspected (11515 bytes; SHA-256 059f2bcca9e8cc822e295de13037931557fe805527c4aeb833519cd7bb1de9a8).",
          "observed_at": "2026-09-03T05:51:51.649Z",
          "payload": {}
        }
      ],
      "unknowns": [
        "Actual runtime behavior not tested",
        "Real-world usage not observed",
        "Network access for metabolomics-USI loading not verified"
      ],
      "id": "REV_980848404B52",
      "resource_id": "RES_E41B7843016D",
      "evaluator_type": "platform_ai",
      "provider": "deepseek",
      "model": "deepseek-v4-flash",
      "review_scope": "source-inspected-skill",
      "created_at": "2026-09-03T06:00:56.877Z"
    }
  }
}