[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75BQXQ1W4MH7WTD4GGNBGMC":3,"skill-same:01M75BQXQ1W4MH7WTD4GGNBGMC":52},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M75BQXQ1W4MH7WTD4GGNBGMC","audit-augmentation",null,"Augments Trailmark code graphs with external audit findings from SARIF static analysis results and weAudit annotation files. Maps findings to graph nodes by file and line overlap, creates severity-based subgraphs, and enables cross-referencing findings with pre-analysis data (blast radius, taint, etc.). Use when projecting SARIF results onto a code graph, overlaying weAudit annotations, cross-referencing Semgrep or CodeQL findings with call graph data, or visualizing audit findings in the context of code structure.","agisota\u002Fold-one","agisota","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F121413592?v=4","01M75B4BRNT67EC1NDRT8QZEP2","01M75B4BS7QR9VP580MSCPTS3X",3,"MIT","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Faudit-augmentation\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: audit-augmentation\ndescription: >\n  Augments Trailmark code graphs with external audit findings from SARIF static\n  analysis results and weAudit annotation files. Maps findings to graph nodes by\n  file and line overlap, creates severity-based subgraphs, and enables\n  cross-referencing findings with pre-analysis data (blast radius, taint, etc.).\n  Use when projecting SARIF results onto a code graph, overlaying weAudit\n  annotations, cross-referencing Semgrep or CodeQL findings with call graph\n  data, or visualizing audit findings in the context of code structure.\n---\n\n# Audit Augmentation\n\nProjects findings from external tools (SARIF) and human auditors (weAudit)\nonto Trailmark code graphs as annotations and subgraphs.\n\n## When to Use\n\n- Importing Semgrep, CodeQL, or other SARIF-producing tool results into a graph\n- Importing weAudit audit annotations into a graph\n- Cross-referencing static analysis findings with blast radius or taint data\n- Querying which functions have high-severity findings\n- Visualizing audit coverage alongside code structure\n\n## When NOT to Use\n\n- Running static analysis tools (use semgrep\u002Fcodeql directly, then import)\n- Building the code graph itself (use the `trailmark` skill)\n- Generating diagrams (use the `diagramming-code` skill after augmenting)\n\n## Rationalizations to Reject\n\n| Rationalization | Why It's Wrong | Required Action |\n|-----------------|----------------|-----------------|\n| \"The user only asked about SARIF, skip pre-analysis\" | Without pre-analysis, you can't cross-reference findings with blast radius or taint | Always run `engine.preanalysis()` before augmenting |\n| \"Unmatched findings don't matter\" | Unmatched findings may indicate parsing gaps or out-of-scope files | Report unmatched count and investigate if high |\n| \"One severity subgraph is enough\" | Different severities need different triage workflows | Query all severity subgraphs, not just `error` |\n| \"SARIF results speak for themselves\" | Findings without graph context lack blast radius and taint reachability | Cross-reference with pre-analysis subgraphs |\n| \"weAudit and SARIF overlap, pick one\" | Human auditors and tools find different things | Import both when available |\n| \"Tool isn't installed, I'll do it manually\" | Manual analysis misses what tooling catches | Install trailmark first |\n\n---\n\n## Installation\n\n**MANDATORY:** If `uv run trailmark` fails, install trailmark first:\n\n```bash\nuv pip install trailmark\n```\n\n## Quick Start\n\n### CLI\n\n```bash\n# Augment with SARIF\nuv run trailmark augment {targetDir} --sarif results.sarif\n\n# Augment with weAudit\nuv run trailmark augment {targetDir} --weaudit .vscode\u002Falice.weaudit\n\n# Both at once, output JSON\nuv run trailmark augment {targetDir} \\\n    --sarif results.sarif \\\n    --weaudit .vscode\u002Falice.weaudit \\\n    --json\n```\n\n### Programmatic API\n\n```python\nfrom trailmark.query.api import QueryEngine\n\nengine = QueryEngine.from_directory(\"{targetDir}\", language=\"python\")\n\n# Run pre-analysis first for cross-referencing\nengine.preanalysis()\n\n# Augment with SARIF\nresult = engine.augment_sarif(\"results.sarif\")\n# result: {matched_findings: 12, unmatched_findings: 3, subgraphs_created: [...]}\n\n# Augment with weAudit\nresult = engine.augment_weaudit(\".vscode\u002Falice.weaudit\")\n\n# Query findings\nengine.findings()                                       # All findings\nengine.subgraph(\"sarif:error\")                          # High-severity SARIF\nengine.subgraph(\"weaudit:high\")                         # High-severity weAudit\nengine.subgraph(\"sarif:semgrep\")                        # By tool name\nengine.annotations_of(\"function_name\")                  # Per-node lookup\n```\n\n## Workflow\n\n```\nAugmentation Progress:\n- [ ] Step 1: Build graph and run pre-analysis\n- [ ] Step 2: Locate SARIF\u002FweAudit files\n- [ ] Step 3: Run augmentation\n- [ ] Step 4: Inspect results and subgraphs\n- [ ] Step 5: Cross-reference with pre-analysis\n```\n\n**Step 1:** Build the graph and run pre-analysis for blast radius and taint\ncontext:\n\n```python\nengine = QueryEngine.from_directory(\"{targetDir}\", language=\"{lang}\")\nengine.preanalysis()\n```\n\n**Step 2:** Locate input files:\n- **SARIF**: Usually output by tools like `semgrep --sarif -o results.sarif`\n  or `codeql database analyze --format=sarif-latest`\n- **weAudit**: Stored in `.vscode\u002F\u003Cusername>.weaudit` within the workspace\n\n**Step 3:** Run augmentation via `engine.augment_sarif()` or\n`engine.augment_weaudit()`. Check `unmatched_findings` in the result — these\nare findings whose file\u002Fline locations didn't overlap any parsed code unit.\n\n**Step 4:** Query findings and subgraphs. Use `engine.findings()` to list all\nannotated nodes. Use `engine.subgraph_names()` to see available subgraphs.\n\n**Step 5:** Cross-reference with pre-analysis data to prioritize:\n- Findings on tainted nodes: overlap `sarif:error` with `tainted` subgraph\n- Findings on high blast radius nodes: overlap with `high_blast_radius`\n- Findings on privilege boundaries: overlap with `privilege_boundary`\n\n## Annotation Format\n\nFindings are stored as standard Trailmark annotations:\n\n- **Kind**: `finding` (tool-generated) or `audit_note` (human notes)\n- **Source**: `sarif:\u003Ctool_name>` or `weaudit:\u003Cauthor>`\n- **Description**: Compact single-line:\n  `[SEVERITY] rule-id: message (tool)`\n\n## Subgraphs Created\n\n| Subgraph | Contents |\n|----------|----------|\n| `sarif:error` | Nodes with SARIF error-level findings |\n| `sarif:warning` | Nodes with SARIF warning-level findings |\n| `sarif:note` | Nodes with SARIF note-level findings |\n| `sarif:\u003Ctool>` | Nodes flagged by a specific tool |\n| `weaudit:high` | Nodes with high-severity weAudit findings |\n| `weaudit:medium` | Nodes with medium-severity weAudit findings |\n| `weaudit:low` | Nodes with low-severity weAudit findings |\n| `weaudit:findings` | All weAudit findings (entryType=0) |\n| `weaudit:notes` | All weAudit notes (entryType=1) |\n\n## How Matching Works\n\nFindings are matched to graph nodes by file path and line range overlap:\n\n1. Finding file path is normalized relative to the graph's `root_path`\n2. Nodes whose `location.file_path` matches AND whose line range overlaps are\n   selected\n3. The tightest match (smallest span) is preferred\n4. If a finding's location doesn't overlap any node, it counts as unmatched\n\nSARIF paths may be relative, absolute, or `file:\u002F\u002F` URIs — all are handled.\nweAudit uses 0-indexed lines which are converted to 1-indexed automatically.\n\n## Supporting Documentation\n\n- **[references\u002Fformats.md](references\u002Fformats.md)** — SARIF 2.1.0 and\n  weAudit file format field reference\n","# Audit Augmentation\n\nProjects findings from external tools (SARIF) and human auditors (weAudit)\nonto Trailmark code graphs as annotations and subgraphs.\n\n## When to Use\n\n- Importing Semgrep, CodeQL, or other SARIF-producing tool results into a graph\n- Importing weAudit audit annotations into a graph\n- Cross-referencing static analysis findings with blast radius or taint data\n- Querying which functions have high-severity findings\n- Visualizing audit coverage alongside code structure\n\n## When NOT to Use\n\n- Running static analysis tools (use semgrep\u002Fcodeql directly, then import)\n- Building the code graph itself (use the `trailmark` skill)\n- Generating diagrams (use the `diagramming-code` skill after augmenting)\n\n## Rationalizations to Reject\n\n| Rationalization | Why It's Wrong | Required Action |\n|-----------------|----------------|-----------------|\n| \"The user only asked about SARIF, skip pre-analysis\" | Without pre-analysis, you can't cross-reference findings with blast radius or taint | Always run `engine.preanalysis()` before augmenting |\n| \"Unmatched findings don't matter\" | Unmatched findings may indicate parsing gaps or out-of-scope files | Report unmatched count and investigate if high |\n| \"One severity subgraph is enough\" | Different severities need different triage workflows | Query all severity subgraphs, not just `error` |\n| \"SARIF results speak for themselves\" | Findings without graph context lack blast radius and taint reachability | Cross-reference with pre-analysis subgraphs |\n| \"weAudit and SARIF overlap, pick one\" | Human auditors and tools find different things | Import both when available |\n| \"Tool isn't installed, I'll do it manually\" | Manual analysis misses what tooling catches | Install trailmark first |\n\n---\n\n## Installation\n\n**MANDATORY:** If `uv run trailmark` fails, install trailmark first:\n\n```bash\nuv pip install trailmark\n```\n\n## Quick Start\n\n### CLI\n\n```bash\n# Augment with SARIF\nuv run trailmark augment {targetDir} --sarif results.sarif\n\n# Augment with weAudit\nuv run trailmark augment {targetDir} --weaudit .vscode\u002Falice.weaudit\n\n# Both at once, output JSON\nuv run trailmark augment {targetDir} \\\n    --sarif results.sarif \\\n    --weaudit .vscode\u002Falice.weaudit \\\n    --json\n```\n\n### Programmatic API\n\n```python\nfrom trailmark.query.api import QueryEngine\n\nengine = QueryEngine.from_directory(\"{targetDir}\", language=\"python\")\n\n# Run pre-analysis first for cross-referencing\nengine.preanalysis()\n\n# Augment with SARIF\nresult = engine.augment_sarif(\"results.sarif\")\n# result: {matched_findings: 12, unmatched_findings: 3, subgraphs_created: [...]}\n\n# Augment with weAudit\nresult = engine.augment_weaudit(\".vscode\u002Falice.weaudit\")\n\n# Query findings\nengine.findings()                                       # All findings\nengine.subgraph(\"sarif:error\")                          # High-severity SARIF\nengine.subgraph(\"weaudit:high\")                         # High-severity weAudit\nengine.subgraph(\"sarif:semgrep\")                        # By tool name\nengine.annotations_of(\"function_name\")                  # Per-node lookup\n```\n\n## Workflow\n\n```\nAugmentation Progress:\n- [ ] Step 1: Build graph and run pre-analysis\n- [ ] Step 2: Locate SARIF\u002FweAudit files\n- [ ] Step 3: Run augmentation\n- [ ] Step 4: Inspect results and subgraphs\n- [ ] Step 5: Cross-reference with pre-analysis\n```\n\n**Step 1:** Build the graph and run pre-analysis for blast radius and taint\ncontext:\n\n```python\nengine = QueryEngine.from_directory(\"{targetDir}\", language=\"{lang}\")\nengine.preanalysis()\n```\n\n**Step 2:** Locate input files:\n- **SARIF**: Usually output by tools like `semgrep --sarif -o results.sarif`\n  or `codeql database analyze --format=sarif-latest`\n- **weAudit**: Stored in `.vscode\u002F\u003Cusername>.weaudit` within the workspace\n\n**Step 3:** Run augmentation via `engine.augment_sarif()` or\n`engine.augment_weaudit()`. Check `unmatched_findings` in the result — these\nare findings whose file\u002Fline locations didn't overlap any parsed code unit.\n\n**Step 4:** Query findings and subgraphs. Use `engine.findings()` to list all\nannotated nodes. Use `engine.subgraph_names()` to see available subgraphs.\n\n**Step 5:** Cross-reference with pre-analysis data to prioritize:\n- Findings on tainted nodes: overlap `sarif:error` with `tainted` subgraph\n- Findings on high blast radius nodes: overlap with `high_blast_radius`\n- Findings on privilege boundaries: overlap with `privilege_boundary`\n\n## Annotation Format\n\nFindings are stored as standard Trailmark annotations:\n\n- **Kind**: `finding` (tool-generated) or `audit_note` (human notes)\n- **Source**: `sarif:\u003Ctool_name>` or `weaudit:\u003Cauthor>`\n- **Description**: Compact single-line:\n  `[SEVERITY] rule-id: message (tool)`\n\n## Subgraphs Created\n\n| Subgraph | Contents |\n|----------|----------|\n| `sarif:error` | Nodes with SARIF error-level findings |\n| `sarif:warning` | Nodes with SARIF warning-level findings |\n| `sarif:note` | Nodes with SARIF note-level findings |\n| `sarif:\u003Ctool>` | Nodes flagged by a specific tool |\n| `weaudit:high` | Nodes with high-severity weAudit findings |\n| `weaudit:medium` | Nodes with medium-severity weAudit findings |\n| `weaudit:low` | Nodes with low-severity weAudit findings |\n| `weaudit:findings` | All weAudit findings (entryType=0) |\n| `weaudit:notes` | All weAudit notes (entryType=1) |\n\n## How Matching Works\n\nFindings are matched to graph nodes by file path and line range overlap:\n\n1. Finding file path is normalized relative to the graph's `root_path`\n2. Nodes whose `location.file_path` matches AND whose line range overlaps are\n   selected\n3. The tightest match (smallest span) is preferred\n4. If a finding's location doesn't overlap any node, it counts as unmatched\n\nSARIF paths may be relative, absolute, or `file:\u002F\u002F` URIs — all are handled.\nweAudit uses 0-indexed lines which are converted to 1-indexed automatically.\n\n## Supporting Documentation\n\n- **[references\u002Fformats.md](references\u002Fformats.md)** — SARIF 2.1.0 and\n  weAudit file format field reference\n",{"name":5,"description":7},"main","f37de8f681f0c0ca0e0ebab6e5fddf764ca7553d","skills\u002Faudit-augmentation",1,"https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one","https:\u002F\u002Fagisota.github.io\u002Fold-one\u002F","https:\u002F\u002Fgithub.com\u002Fagisota","pzd.world","2026-07-04 22:32:06",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add agisota\u002Fold-one --skill audit-augmentation",{"tool":38,"command":39},"bunx","bunx skills add agisota\u002Fold-one --skill audit-augmentation",{"tool":41,"command":42},"pnpm","pnpm dlx skills add agisota\u002Fold-one --skill audit-augmentation","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Faudit-augmentation\u002FSKILL.md",true,[46],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"references\u002Fformats.md","REFERENCE","参考文档",3609,"https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Faudit-augmentation\u002Freferences\u002Fformats.md",[53,60,67,76,83,90],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":18},"01M75KRGZWQWE9JDBS6RX42NWV","zoom-out","Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fzoom-out\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M75KRCZHKE0ZYAQFFYHS0YNP","zeroize-audit","Detects missing zeroization of sensitive data in source code and identifies zeroization removed by compiler optimizations, with assembly-level analysis, and control-flow verification. Use for auditing C\u002FC++\u002FRust code handling secrets, keys, passwords, or other sensitive data.","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fzeroize-audit\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":71,"licenseFileUrl":72,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":18},"01M75KR94KYQ30DTE1P9WNDAE0","yeet","Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using the GitHub CLI (`gh`).","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fyeet\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fyeet\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":18},"01M75KR3H13YJ9QHMD49818FA1","yara-rule-authoring","Guides authoring of high-quality YARA-X detection rules for malware identification. Use when writing, reviewing, or optimizing YARA rules. Covers naming conventions, string selection, performance optimization, migration from legacy YARA, and false positive reduction. Triggers on: YARA, YARA-X, malware detection, threat hunting, IOC, signature, crx module, dex module.","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fyara-rule-authoring\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":18},"01M75KQMPY8A4Y8XTDD2DT0M9T","x-twitter-growth","X\u002FTwitter growth engine for building audience, crafting viral content, and analyzing engagement. Use when the user wants to grow on X\u002FTwitter, write tweets or threads, analyze their X profile, research competitors on X, plan a posting strategy, or optimize engagement. Complements social-content (generic multi-platform) with X-specific depth: algorithm mechanics, thread engineering, reply strategy, profile optimization, and competitive intelligence via web search.","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fx-twitter-growth\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":18},"01M75KQHNZ0ANZNJGZY6M8MDAK","x-api","X\u002FTwitter API integration for posting tweets, threads, reading timelines, search, and analytics. Covers OAuth auth patterns, rate limits, and platform-native content posting. Use when the user wants to interact with X programmatically.","https:\u002F\u002Fgithub.com\u002Fagisota\u002Fold-one\u002Fblob\u002Fmain\u002Fskills\u002Fx-api\u002FSKILL.md",[],[]]