[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6NT70264BPES27S0DMCZD22":3,"skill-same:01M6NT70264BPES27S0DMCZD22":64},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":35,"linkOnly":36,"markdownContent":37,"markdownBody":38,"frontMatter":39,"refName":42,"commitSha":43,"skillDirectory":44,"forksCount":14,"repositoryHtmlUrl":45,"repositoryHomepageUrl":6,"ownerHtmlUrl":46,"ownerBlogUrl":47,"ownerDescription":48,"updatedAt":49,"install":50,"resources":63},"01M6NT70264BPES27S0DMCZD22","agentica-server",null,"Agentica server + Claude proxy setup - architecture, startup sequence, debugging","rubicanjr\u002FFinCognis","rubicanjr","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F234912519?v=4","01M6NT156NND8J474G34SB3923","Rubi","01M6NT15B70RWXE1N3YV0BZY8A",0,"MIT","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fagentica-server\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34],"server","agentica server","architecture","setup","debugging","proxy","startup","Bash","read","false","sequence","2026-11-10 10:12:30",false,"---\nname: agentica-server\ndescription: Agentica server + Claude proxy setup - architecture, startup sequence, debugging\nallowed-tools: [Bash, Read]\nuser-invocable: false\n---\n\n# Agentica Server + Claude Proxy Setup\n\nComplete reference for running Agentica SDK with a local Claude proxy. This enables Python agents to use Claude CLI as their inference backend.\n\n## When to Use\n\nUse this skill when:\n- Starting Agentica development with Claude proxy\n- Debugging connection issues between SDK, server, and proxy\n- Setting up a fresh Agentica environment\n- Troubleshooting agent tool access or hallucination issues\n\n## Architecture\n\n```\nAgentica SDK (client code)\n    | S_M_BASE_URL=http:\u002F\u002Flocalhost:2345\n    v\nClientSessionManager\n    |\n    v\nAgentica Server (agentica-server)\n    | INFERENCE_ENDPOINT_URL=http:\u002F\u002Flocalhost:8080\u002Fv1\u002Fchat\u002Fcompletions\n    v\nClaude Proxy (claude_proxy.py)\n    |\n    v\nClaude CLI (claude -p)\n```\n\n## Environment Variables\n\n| Variable | Set By | Used By | Purpose |\n|----------|--------|---------|---------|\n| `INFERENCE_ENDPOINT_URL` | Human | agentica-server | Where server sends LLM inference requests |\n| `S_M_BASE_URL` | Human | Agentica SDK client | Where SDK connects to session manager |\n\n**KEY:** These are NOT the same endpoint!\n- SDK connects to server (port 2345)\n- Server connects to proxy (port 8080)\n\n## Startup Sequence\n\nMust start in this order (each in a separate terminal):\n\n### Terminal 1: Claude Proxy\n\n```bash\nuv run python scripts\u002Fagentica\u002Fclaude_proxy.py --port 8080\n```\n\n### Terminal 2: Agentica Server\n\n**MUST run from its directory:**\n\n```bash\ncd workspace\u002Fagentica-research\u002Fagentica-server\nINFERENCE_ENDPOINT_URL=http:\u002F\u002Flocalhost:8080\u002Fv1\u002Fchat\u002Fcompletions uv run agentica-server --port 2345\n```\n\n### Terminal 3: Your Agent Script\n\n```bash\nS_M_BASE_URL=http:\u002F\u002Flocalhost:2345 uv run python scripts\u002Fagentica\u002Fyour_script.py\n```\n\n## Health Checks\n\n```bash\n# Claude proxy health\ncurl http:\u002F\u002Flocalhost:8080\u002Fhealth\n\n# Agentica server health\ncurl http:\u002F\u002Flocalhost:2345\u002Fhealth\n```\n\n## Common Errors & Fixes\n\n### 1. APIConnectionError after agent spawn\n\n**Symptom:** Agent spawns successfully but fails on first call with connection error.\n\n**Cause:** Claude proxy returning plain JSON instead of SSE format.\n\n**Fix:** Proxy must return Server-Sent Events format:\n```\ndata: {\"choices\": [...]}\\n\\n\n```\n\n### 2. ModuleNotFoundError for agentica-server\n\n**Symptom:** `ModuleNotFoundError: No module named 'agentica_server'`\n\n**Cause:** Running `uv run agentica-server` from wrong directory.\n\n**Fix:** Must `cd workspace\u002Fagentica-research\u002Fagentica-server` first.\n\n### 3. Agent can't use Read\u002FWrite\u002FEdit tools\n\n**Symptom:** Agent asks for file contents instead of reading them.\n\n**Cause:** Missing `--allowedTools` in claude_proxy.py CLI call.\n\n**Fix:** Proxy must pass tool permissions:\n```bash\nclaude -p ... --allowedTools Read Write Edit Bash\n```\n\n### 4. Agent claims success but didn't do task\n\n**Symptom:** Agent says \"I've created the file\" but file doesn't exist.\n\n**Cause:** Hallucination - agent describing intended actions without executing.\n\n**Fix:** Added emphatic anti-hallucination prompt in REPL_BASELINE:\n```\nCRITICAL: Use ACTUAL tools. Never DESCRIBE using tools.\n```\n\n### 5. Timeout on agent.call()\n\n**Symptom:** Call hangs for 30+ seconds then times out.\n\n**Cause:** Claude CLI taking too long or stuck in a loop.\n\n**Fix:** Check proxy logs for the actual CLI output. May need to simplify prompt.\n\n## Key Files\n\n| File | Purpose |\n|------|---------|\n| `scripts\u002Fagentica\u002Fclaude_proxy.py` | OpenAI-compatible proxy with SSE streaming |\n| `workspace\u002Fagentica-research\u002Fagentica-server\u002F` | Local agentica-server installation |\n| `scripts\u002Fagentica\u002FPATTERNS.md` | Multi-agent pattern documentation |\n\n## Quick Verification\n\nTest the full stack:\n\n```bash\n# 1. Verify proxy responds\ncurl http:\u002F\u002Flocalhost:8080\u002Fhealth\n\n# 2. Verify server responds\ncurl http:\u002F\u002Flocalhost:2345\u002Fhealth\n\n# 3. Test inference through proxy\ncurl http:\u002F\u002Flocalhost:8080\u002Fv1\u002Fchat\u002Fcompletions \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"model\":\"claude\",\"messages\":[{\"role\":\"user\",\"content\":\"Say hello\"}]}'\n```\n\n## Checklist\n\nBefore running agents:\n- [ ] Claude proxy running on port 8080\n- [ ] Agentica server running on port 2345 (from its directory)\n- [ ] `S_M_BASE_URL` set for client scripts\n- [ ] `INFERENCE_ENDPOINT_URL` set for server\n- [ ] Both health checks return 200\n","# Agentica Server + Claude Proxy Setup\n\nComplete reference for running Agentica SDK with a local Claude proxy. This enables Python agents to use Claude CLI as their inference backend.\n\n## When to Use\n\nUse this skill when:\n- Starting Agentica development with Claude proxy\n- Debugging connection issues between SDK, server, and proxy\n- Setting up a fresh Agentica environment\n- Troubleshooting agent tool access or hallucination issues\n\n## Architecture\n\n```\nAgentica SDK (client code)\n    | S_M_BASE_URL=http:\u002F\u002Flocalhost:2345\n    v\nClientSessionManager\n    |\n    v\nAgentica Server (agentica-server)\n    | INFERENCE_ENDPOINT_URL=http:\u002F\u002Flocalhost:8080\u002Fv1\u002Fchat\u002Fcompletions\n    v\nClaude Proxy (claude_proxy.py)\n    |\n    v\nClaude CLI (claude -p)\n```\n\n## Environment Variables\n\n| Variable | Set By | Used By | Purpose |\n|----------|--------|---------|---------|\n| `INFERENCE_ENDPOINT_URL` | Human | agentica-server | Where server sends LLM inference requests |\n| `S_M_BASE_URL` | Human | Agentica SDK client | Where SDK connects to session manager |\n\n**KEY:** These are NOT the same endpoint!\n- SDK connects to server (port 2345)\n- Server connects to proxy (port 8080)\n\n## Startup Sequence\n\nMust start in this order (each in a separate terminal):\n\n### Terminal 1: Claude Proxy\n\n```bash\nuv run python scripts\u002Fagentica\u002Fclaude_proxy.py --port 8080\n```\n\n### Terminal 2: Agentica Server\n\n**MUST run from its directory:**\n\n```bash\ncd workspace\u002Fagentica-research\u002Fagentica-server\nINFERENCE_ENDPOINT_URL=http:\u002F\u002Flocalhost:8080\u002Fv1\u002Fchat\u002Fcompletions uv run agentica-server --port 2345\n```\n\n### Terminal 3: Your Agent Script\n\n```bash\nS_M_BASE_URL=http:\u002F\u002Flocalhost:2345 uv run python scripts\u002Fagentica\u002Fyour_script.py\n```\n\n## Health Checks\n\n```bash\n# Claude proxy health\ncurl http:\u002F\u002Flocalhost:8080\u002Fhealth\n\n# Agentica server health\ncurl http:\u002F\u002Flocalhost:2345\u002Fhealth\n```\n\n## Common Errors & Fixes\n\n### 1. APIConnectionError after agent spawn\n\n**Symptom:** Agent spawns successfully but fails on first call with connection error.\n\n**Cause:** Claude proxy returning plain JSON instead of SSE format.\n\n**Fix:** Proxy must return Server-Sent Events format:\n```\ndata: {\"choices\": [...]}\\n\\n\n```\n\n### 2. ModuleNotFoundError for agentica-server\n\n**Symptom:** `ModuleNotFoundError: No module named 'agentica_server'`\n\n**Cause:** Running `uv run agentica-server` from wrong directory.\n\n**Fix:** Must `cd workspace\u002Fagentica-research\u002Fagentica-server` first.\n\n### 3. Agent can't use Read\u002FWrite\u002FEdit tools\n\n**Symptom:** Agent asks for file contents instead of reading them.\n\n**Cause:** Missing `--allowedTools` in claude_proxy.py CLI call.\n\n**Fix:** Proxy must pass tool permissions:\n```bash\nclaude -p ... --allowedTools Read Write Edit Bash\n```\n\n### 4. Agent claims success but didn't do task\n\n**Symptom:** Agent says \"I've created the file\" but file doesn't exist.\n\n**Cause:** Hallucination - agent describing intended actions without executing.\n\n**Fix:** Added emphatic anti-hallucination prompt in REPL_BASELINE:\n```\nCRITICAL: Use ACTUAL tools. Never DESCRIBE using tools.\n```\n\n### 5. Timeout on agent.call()\n\n**Symptom:** Call hangs for 30+ seconds then times out.\n\n**Cause:** Claude CLI taking too long or stuck in a loop.\n\n**Fix:** Check proxy logs for the actual CLI output. May need to simplify prompt.\n\n## Key Files\n\n| File | Purpose |\n|------|---------|\n| `scripts\u002Fagentica\u002Fclaude_proxy.py` | OpenAI-compatible proxy with SSE streaming |\n| `workspace\u002Fagentica-research\u002Fagentica-server\u002F` | Local agentica-server installation |\n| `scripts\u002Fagentica\u002FPATTERNS.md` | Multi-agent pattern documentation |\n\n## Quick Verification\n\nTest the full stack:\n\n```bash\n# 1. Verify proxy responds\ncurl http:\u002F\u002Flocalhost:8080\u002Fhealth\n\n# 2. Verify server responds\ncurl http:\u002F\u002Flocalhost:2345\u002Fhealth\n\n# 3. Test inference through proxy\ncurl http:\u002F\u002Flocalhost:8080\u002Fv1\u002Fchat\u002Fcompletions \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"model\":\"claude\",\"messages\":[{\"role\":\"user\",\"content\":\"Say hello\"}]}'\n```\n\n## Checklist\n\nBefore running agents:\n- [ ] Claude proxy running on port 8080\n- [ ] Agentica server running on port 2345 (from its directory)\n- [ ] `S_M_BASE_URL` set for client scripts\n- [ ] `INFERENCE_ENDPOINT_URL` set for server\n- [ ] Both health checks return 200\n",{"name":5,"description":7,"allowed-tools":40,"user-invocable":36},[31,41],"Read","main","70e1c350500ee750987420bbae48837afa906b7e","skills\u002Fagentica-server","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis","https:\u002F\u002Fgithub.com\u002Frubicanjr","linktr.ee\u002Ffinanskodu","Industrial Engineer & CIO @FinansKodu. Architecting AI-driven financial agents and autonomous workflows. 🏗️ Building systems, not just prompts.","2026-06-09 13:50:15",{"source":8,"skillName":5,"commands":51,"prompt":61,"zipAvailable":62},[52,55,58],{"tool":53,"command":54},"npx","npx skills add rubicanjr\u002FFinCognis --skill agentica-server",{"tool":56,"command":57},"bunx","bunx skills add rubicanjr\u002FFinCognis --skill agentica-server",{"tool":59,"command":60},"pnpm","pnpm dlx skills add rubicanjr\u002FFinCognis --skill agentica-server","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fagentica-server\u002FSKILL.md",true,[],[65,84,92,112,142,161],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":74,"publishedAt":35},"01M6NWS9DAXJTADT4T5MB49X8W","workflow-router","Goal-based workflow orchestration - routes tasks to specialist agents based on user goals","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow-router\u002FSKILL.md",[71],{"categoryNo":72,"categoryName":73,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[75,76,77,78,79,80,81,82,83],"workflow router","workflow","router","orchestration","goals","goal","user","workflow orchestration","tasks",{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":35},"01M6NWS3RETSC0SHP16HP66E14","wiring","Wiring Verification","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fwiring\u002FSKILL.md",[],[86,91,33],"verification",{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":101,"publishedAt":35},"01M6NWS0XW9CVQZBDA1EGW0TWC","websocket-patterns","Connection management, room patterns, reconnection strategies, message buffering, and binary protocol design.","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fwebsocket-patterns\u002Fskill.md",[98],{"categoryNo":99,"categoryName":100,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",[102,103,104,105,106,107,108,109,110,111],"websocket","patterns","websocket patterns","design","protocol","management","message","strategies","binary","connection",{"skillNo":113,"name":114,"nameZh":6,"description":115,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":116,"categories":117,"keywords":122,"publishedAt":35},"01M6NWRDQDX9ZNETAWRRMQWV52","visual-verdict","Screenshot comparison QA for frontend development. Takes a screenshot of the current implementation, scores it across multiple visual dimensions, and returns a structured PASS\u002FREVISE\u002FFAIL verdict with concrete fixes. Use when implementing UI from a design reference or verifying visual correctness.","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fvisual-verdict\u002FSKILL.md",[118,121],{"categoryNo":119,"categoryName":120,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000009","前端开发",{"categoryNo":72,"categoryName":73,"taxonomyType":21,"taxonomyTypeDesc":22},[123,124,125,126,127,128,129,130,131,132,133,134,135,105,136,137,138,139,140,141],"visual","verdict","visual verdict","ui","across","revise","comparison","correctness","implementing","for","fixes","dimensions","frontend","development","qa","screenshot","returns","use","frontend development",{"skillNo":143,"name":144,"nameZh":6,"description":145,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":146,"categories":147,"keywords":148,"publishedAt":35},"01M6NWR8HSNRS7MNDK2J02QYMN","verification-loop","Comprehensive verification system covering build, types, lint, tests, security, and diff review before a PR.","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fverification-loop\u002FSKILL.md",[],[149,150,91,151,152,153,154,155,156,157,158,159,160],"verification loop","loop","lint","review","security","pr","system","diff","build","tests","diff review","types",{"skillNo":162,"name":163,"nameZh":6,"description":164,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":165,"categories":166,"keywords":167,"publishedAt":35},"01M6NWR4HHSFR0VR5EXFRWA747","vector-db-patterns","Embedding strategies, ANN algorithms, hybrid search, RAG chunking strategies, and reranking for semantic search and retrieval.","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fvector-db-patterns\u002Fskill.md",[],[168,169,170,171,103,172,173,174,175,109,176,177,178,179,180,132,181,182],"vector db patterns","vector db","db","vector","semantic search","search","embedding strategies","algorithms","chunking","semantic","retrieval","embedding","Hybrid Search","hybrid","rag"]