{"id":"09bf386e-f9b7-4d50-b7d9-23f8f5df2af2","shortId":"EpmAGx","kind":"skill","title":"PheroPath","tagline":"A filesystem-based stigmergy communication protocol. Use this to leave invisible \"pheromones\" (signals) on files to communicate context, risks, or status to other agents or your future self without modifying file content.","description":"# PheroPath Agent Skill\n\nPheroPath allows you to attach context (DANGER, TODO, SAFE, INSIGHT) to files using Extended Attributes (or a sidecar fallback).\n\n## Usage Guide\n\n### 1. Secrete (Leave a Signal)\n**Script:** `scripts/secrete.py`\n\n**When to use:**\n- **DANGER**: You found a bug/risk you cannot fix immediately.\n- **TODO**: You are leaving untidied code or suggestions.\n- **SAFE**: You verified a module is robust.\n- **INSIGHT**: You want to explain *why* something is implemented this way.\n\n**Bash Examples (Few-Shot):**\n\n```bash\n# Example 1: Mark a file as dangerous due to a race condition\npython3 scripts/secrete.py \"src/concurrency.py\" \"DANGER\" \"Rate limit race condition under high load\" --intensity 1.0\n\n# Example 2: Leave a TODO note for refactoring\npython3 scripts/secrete.py \"src/legacy_api.py\" \"TODO\" \"Needs migration to v2 API schema\"\n\n# Example 3: Mark a test file as verified\npython3 scripts/secrete.py \"tests/test_auth.py\" \"SAFE\" \"Passed all penetration tests\"\n\n# Example 4: Add architectural insight\npython3 scripts/secrete.py \"src/core/engine.py\" \"INSIGHT\" \"Core loop logic derived from paper X\" --ttl 168\n```\n\n### 2. Sniff (Read Signals)\n**Script:** `scripts/sniff.py`\n\n**When to use:**\n- **ALWAYS** before starting a task in an unfamiliar directory.\n- Before modifying critical files to check for `DANGER`.\n\n**Bash Examples (Few-Shot):**\n\n```bash\n# Example 1: Sniff a specific file\npython3 scripts/sniff.py \"src/main.py\"\n\n# Example 2: Sniff an entire directory (recursive) to gather context\npython3 scripts/sniff.py \"src/\" --min-intensity 0.1\n\n# Example 3: Parse output (it is JSON)\npython3 scripts/sniff.py \"src/\" | jq '.[].message'\n```\n\n### 3. Cleanse (Remove Signals)\n**Script:** `scripts/cleanse.py`\n\n**When to use:**\n- After fixing a bug (remove `DANGER`).\n- After completing a task (remove `TODO`).\n\n**Bash Examples (Few-Shot):**\n\n```bash\n# Example 1: Remove signal from a specific file (e.g. after fixing it)\npython3 scripts/cleanse.py \"src/concurrency.py\"\n\n# Example 2: Prune weak signals (intensity < 0.2) from a directory\npython3 scripts/cleanse.py \"src/\" --prune 0.2\n\n# Example 3: Clear ALL signals from a directory (Reset)\npython3 scripts/cleanse.py \"src/\" --all\n```","tags":["pheropath","starpig1129","agent-skills","ai-agent","antigravity","claude-code","cursor","llm","python","stigmergy","tools","vscode-extension"],"capabilities":["skill","source-starpig1129","skill-pheropath","topic-agent-skills","topic-ai-agent","topic-antigravity","topic-claude-code","topic-cursor","topic-llm","topic-python","topic-stigmergy","topic-tools","topic-vscode-extension"],"categories":["PheroPath"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/starpig1129/PheroPath","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add starpig1129/PheroPath","source_repo":"https://github.com/starpig1129/PheroPath","install_from":"skills.sh"}},"qualityScore":"0.454","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 8 github stars · SKILL.md body (2,202 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:08:58.494Z","embedding":null,"createdAt":"2026-05-18T13:14:44.319Z","updatedAt":"2026-05-18T19:08:58.494Z","lastSeenAt":"2026-05-18T19:08:58.494Z","tsv":"'0.1':244 '0.2':305,313 '1':59,111,220,285 '1.0':134 '168':186 '2':136,187,229,300 '3':154,246,257,315 '4':170 'add':171 'agent':26,36 'allow':39 'alway':196 'api':151 'architectur':172 'attach':42 'attribut':52 'base':5 'bash':104,109,213,218,278,283 'bug':269 'bug/risk':73 'cannot':75 'check':210 'cleans':258 'clear':316 'code':83 'communic':7,19 'complet':273 'condit':121,129 'content':34 'context':20,43,237 'core':178 'critic':207 'danger':44,69,116,125,212,271 'deriv':181 'directori':204,233,308,321 'due':117 'e.g':292 'entir':232 'exampl':105,110,135,153,169,214,219,228,245,279,284,299,314 'explain':97 'extend':51 'fallback':56 'few-shot':106,215,280 'file':17,33,49,114,158,208,224,291 'filesystem':4 'filesystem-bas':3 'fix':76,267,294 'found':71 'futur':29 'gather':236 'guid':58 'high':131 'immedi':77 'implement':101 'insight':47,93,173,177 'intens':133,243,304 'invis':13 'jq':255 'json':251 'leav':12,61,81,137 'limit':127 'load':132 'logic':180 'loop':179 'mark':112,155 'messag':256 'migrat':148 'min':242 'min-intens':241 'modifi':32,206 'modul':90 'need':147 'note':140 'output':248 'paper':183 'pars':247 'pass':165 'penetr':167 'pheromon':14 'pheropath':1,35,38 'protocol':8 'prune':301,312 'python3':122,143,161,174,225,238,252,296,309,323 'race':120,128 'rate':126 'read':189 'recurs':234 'refactor':142 'remov':259,270,276,286 'reset':322 'risk':21 'robust':92 'safe':46,86,164 'schema':152 'script':64,191,261 'scripts/cleanse.py':262,297,310,324 'scripts/secrete.py':65,123,144,162,175 'scripts/sniff.py':192,226,239,253 'secret':60 'self':30 'shot':108,217,282 'sidecar':55 'signal':15,63,190,260,287,303,318 'skill':37 'skill-pheropath' 'sniff':188,221,230 'someth':99 'source-starpig1129' 'specif':223,290 'src':240,254,311,325 'src/concurrency.py':124,298 'src/core/engine.py':176 'src/legacy_api.py':145 'src/main.py':227 'start':198 'status':23 'stigmergi':6 'suggest':85 'task':200,275 'test':157,168 'tests/test_auth.py':163 'todo':45,78,139,146,277 'topic-agent-skills' 'topic-ai-agent' 'topic-antigravity' 'topic-claude-code' 'topic-cursor' 'topic-llm' 'topic-python' 'topic-stigmergy' 'topic-tools' 'topic-vscode-extension' 'ttl':185 'unfamiliar':203 'untidi':82 'usag':57 'use':9,50,68,195,265 'v2':150 'verifi':88,160 'want':95 'way':103 'weak':302 'without':31 'x':184","prices":[{"id":"4c092c01-f017-47c7-9343-d6e5dcb830d7","listingId":"09bf386e-f9b7-4d50-b7d9-23f8f5df2af2","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"starpig1129","category":"PheroPath","install_from":"skills.sh"},"createdAt":"2026-05-18T13:14:44.319Z"}],"sources":[{"listingId":"09bf386e-f9b7-4d50-b7d9-23f8f5df2af2","source":"github","sourceId":"starpig1129/PheroPath","sourceUrl":"https://github.com/starpig1129/PheroPath","isPrimary":false,"firstSeenAt":"2026-05-18T13:14:44.319Z","lastSeenAt":"2026-05-18T19:08:58.494Z"}],"details":{"listingId":"09bf386e-f9b7-4d50-b7d9-23f8f5df2af2","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"starpig1129","slug":"PheroPath","github":{"repo":"starpig1129/PheroPath","stars":8,"topics":["agent-skills","ai-agent","antigravity","claude-code","cursor","llm","python","stigmergy","tools","vscode-extension"],"license":"mit","html_url":"https://github.com/starpig1129/PheroPath","pushed_at":"2026-01-28T17:29:40Z","description":"PheroPath is a stigmergy-based communication protocol that allows AI Agents to leave invisible \"pheromones\" (signals) on files to coordinate tasks, warn of risks, or share insights without modifying the file content itself.","skill_md_sha":"6c3d26d49ef3e301d56cbc64b14dec24780bf63e","skill_md_path":"SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/starpig1129/PheroPath"},"layout":"root","source":"github","category":"PheroPath","frontmatter":{"name":"PheroPath","description":"A filesystem-based stigmergy communication protocol. Use this to leave invisible \"pheromones\" (signals) on files to communicate context, risks, or status to other agents or your future self without modifying file content."},"skills_sh_url":"https://skills.sh/starpig1129/PheroPath"},"updatedAt":"2026-05-18T19:08:58.494Z"}}