[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78X0MZV7WXASHCE5RKPA70C":3,"skill-same:01M78X0MZV7WXASHCE5RKPA70C":56},{"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":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":33,"commitSha":34,"skillDirectory":35,"forksCount":36,"repositoryHtmlUrl":37,"repositoryHomepageUrl":6,"ownerHtmlUrl":38,"ownerBlogUrl":39,"ownerDescription":40,"updatedAt":41,"install":42,"resources":55},"01M78X0MZV7WXASHCE5RKPA70C","anth-known-pitfalls",null,"Identify and avoid common Claude API anti-patterns and integration mistakes.\nUse when reviewing code, onboarding developers, or debugging subtle issues\nwith Anthropic integrations.\nTrigger with phrases like \"anthropic pitfalls\", \"claude anti-patterns\",\n\"claude mistakes\", \"anthropic common issues\", \"claude gotchas\".","jukeyman\u002Fjukeyman-skills","jukeyman","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F142960420?v=4","01M78FR4Y3DHMMCBCC0GXXNB3F","RICK JEFFERSON","01M78FR4Z8RVQRAD31Y5J7V6EB",1,"MIT","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--anthropic-pack--anth-known-pitfalls\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: anth-known-pitfalls\ndescription: |\n  Identify and avoid common Claude API anti-patterns and integration mistakes.\n  Use when reviewing code, onboarding developers, or debugging subtle issues\n  with Anthropic integrations.\n  Trigger with phrases like \"anthropic pitfalls\", \"claude anti-patterns\",\n  \"claude mistakes\", \"anthropic common issues\", \"claude gotchas\".\nallowed-tools: Read, Write, Edit, Grep\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\ntags: [saas, ai, anthropic]\ncompatible-with: claude-code\n---\n\n# Anthropic Known Pitfalls\n\n## Pitfall 1: Wrong Import \u002F Class Name\n\n```python\n# WRONG — common mistake from OpenAI muscle memory\nfrom anthropic import AnthropicClient  # Does not exist\n\n# CORRECT\nimport anthropic\nclient = anthropic.Anthropic()\n```\n\n```typescript\n\u002F\u002F WRONG\nimport { Anthropic } from '@anthropic-ai\u002Fsdk';\n\n\u002F\u002F CORRECT\nimport Anthropic from '@anthropic-ai\u002Fsdk';  \u002F\u002F Default export\n```\n\n## Pitfall 2: Forgetting max_tokens (Required)\n\n```python\n# WRONG — max_tokens is REQUIRED, unlike OpenAI\nmsg = client.messages.create(\n    model=\"claude-sonnet-4-20250514\",\n    messages=[{\"role\": \"user\", \"content\": \"Hello\"}]\n)  # Error: max_tokens is required\n\n# CORRECT\nmsg = client.messages.create(\n    model=\"claude-sonnet-4-20250514\",\n    max_tokens=1024,  # Always specify\n    messages=[{\"role\": \"user\", \"content\": \"Hello\"}]\n)\n```\n\n## Pitfall 3: System Prompt in Messages Array\n\n```python\n# WRONG — putting system message in messages array (OpenAI pattern)\nmessages = [\n    {\"role\": \"system\", \"content\": \"You are helpful.\"},  # Will cause error\n    {\"role\": \"user\", \"content\": \"Hello\"}\n]\n\n# CORRECT — use the system parameter\nmsg = client.messages.create(\n    model=\"claude-sonnet-4-20250514\",\n    max_tokens=1024,\n    system=\"You are helpful.\",  # Separate parameter\n    messages=[{\"role\": \"user\", \"content\": \"Hello\"}]\n)\n```\n\n## Pitfall 4: Accessing Response Wrong\n\n```python\n# WRONG — OpenAI response pattern\ntext = response.choices[0].message.content  # AttributeError\n\n# CORRECT — Anthropic response pattern\ntext = response.content[0].text  # content is array of blocks\n\n# SAFER — handle multiple content blocks\ntext_blocks = [b.text for b in response.content if b.type == \"text\"]\ntext = \"\\n\".join(text_blocks)\n```\n\n## Pitfall 5: Ignoring Stop Reason\n\n```python\n# WRONG — assuming response is always complete\ntext = msg.content[0].text  # Might be truncated!\n\n# CORRECT — check stop_reason\nif msg.stop_reason == \"max_tokens\":\n    print(\"WARNING: Response was truncated. Increase max_tokens.\")\nelif msg.stop_reason == \"tool_use\":\n    print(\"Claude wants to call a tool — process tool_use blocks\")\nelif msg.stop_reason == \"end_turn\":\n    print(\"Complete response\")\n```\n\n## Pitfall 6: Not Handling tool_use_id Properly\n\n```python\n# WRONG — fabricating tool_use_id\ntool_results = [{\"type\": \"tool_result\", \"tool_use_id\": \"some-id\", \"content\": \"...\"}]\n\n# CORRECT — use the exact ID from Claude's response\nfor block in response.content:\n    if block.type == \"tool_use\":\n        result = execute_tool(block.name, block.input)\n        tool_results.append({\n            \"type\": \"tool_result\",\n            \"tool_use_id\": block.id,  # Must match exactly\n            \"content\": result\n        })\n```\n\n## Pitfall 7: Hardcoding Model IDs Without Versioning\n\n```python\n# RISKY — model aliases may change behavior\nmodel = \"claude-3-5-sonnet\"  # Alias, might point to different version\n\n# BETTER — use dated version for reproducibility\nmodel = \"claude-sonnet-4-20250514\"  # Pinned version\n```\n\n## Pitfall 8: Not Using SDK Auto-Retry\n\n```python\n# UNNECESSARY — writing custom retry logic for 429\u002F5xx\nfor attempt in range(3):\n    try:\n        msg = client.messages.create(...)\n        break\n    except Exception:\n        time.sleep(2 ** attempt)\n\n# BETTER — SDK handles this automatically\nclient = anthropic.Anthropic(max_retries=5)  # Built-in exponential backoff\nmsg = client.messages.create(...)  # Auto-retries 429 and 5xx\n```\n\n## Pitfall 9: Inflated max_tokens\n\n```python\n# WASTEFUL — setting max_tokens higher than needed\n# Doesn't cost more tokens, but increases latency\nmsg = client.messages.create(\n    model=\"claude-sonnet-4-20250514\",\n    max_tokens=200000,  # Way more than needed for a classification\n    messages=[{\"role\": \"user\", \"content\": \"Classify: positive or negative?\"}]\n)\n\n# BETTER — right-size for the task\nmsg = client.messages.create(\n    model=\"claude-haiku-4-20250514\",  # Use Haiku for classification\n    max_tokens=16,  # Only need one word\n    messages=[{\"role\": \"user\", \"content\": \"Classify: positive or negative?\"}]\n)\n```\n\n## Pitfall 10: No Cost Tracking\n\n```python\n# Every response includes usage data — track it\nmsg = client.messages.create(...)\ncost = (msg.usage.input_tokens * 3.0 + msg.usage.output_tokens * 15.0) \u002F 1_000_000\n# Log cost per request to catch runaway spend early\n```\n\n## Quick Reference: Anthropic vs OpenAI Differences\n\n| Feature | OpenAI | Anthropic |\n|---------|--------|-----------|\n| `max_tokens` | Optional | **Required** |\n| System prompt | In messages array | `system` parameter |\n| Response text | `.choices[0].message.content` | `.content[0].text` |\n| Default import | Named export | Default export |\n| Auto-retry | No | Yes (configurable) |\n| Streaming | Yields chunks | SSE events |\n\n## Resources\n\n- [Messages API Reference](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fapi\u002Fmessages)\n- [Python SDK](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fanthropic-sdk-python)\n- [TypeScript SDK](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fanthropic-sdk-typescript)\n","# Anthropic Known Pitfalls\n\n## Pitfall 1: Wrong Import \u002F Class Name\n\n```python\n# WRONG — common mistake from OpenAI muscle memory\nfrom anthropic import AnthropicClient  # Does not exist\n\n# CORRECT\nimport anthropic\nclient = anthropic.Anthropic()\n```\n\n```typescript\n\u002F\u002F WRONG\nimport { Anthropic } from '@anthropic-ai\u002Fsdk';\n\n\u002F\u002F CORRECT\nimport Anthropic from '@anthropic-ai\u002Fsdk';  \u002F\u002F Default export\n```\n\n## Pitfall 2: Forgetting max_tokens (Required)\n\n```python\n# WRONG — max_tokens is REQUIRED, unlike OpenAI\nmsg = client.messages.create(\n    model=\"claude-sonnet-4-20250514\",\n    messages=[{\"role\": \"user\", \"content\": \"Hello\"}]\n)  # Error: max_tokens is required\n\n# CORRECT\nmsg = client.messages.create(\n    model=\"claude-sonnet-4-20250514\",\n    max_tokens=1024,  # Always specify\n    messages=[{\"role\": \"user\", \"content\": \"Hello\"}]\n)\n```\n\n## Pitfall 3: System Prompt in Messages Array\n\n```python\n# WRONG — putting system message in messages array (OpenAI pattern)\nmessages = [\n    {\"role\": \"system\", \"content\": \"You are helpful.\"},  # Will cause error\n    {\"role\": \"user\", \"content\": \"Hello\"}\n]\n\n# CORRECT — use the system parameter\nmsg = client.messages.create(\n    model=\"claude-sonnet-4-20250514\",\n    max_tokens=1024,\n    system=\"You are helpful.\",  # Separate parameter\n    messages=[{\"role\": \"user\", \"content\": \"Hello\"}]\n)\n```\n\n## Pitfall 4: Accessing Response Wrong\n\n```python\n# WRONG — OpenAI response pattern\ntext = response.choices[0].message.content  # AttributeError\n\n# CORRECT — Anthropic response pattern\ntext = response.content[0].text  # content is array of blocks\n\n# SAFER — handle multiple content blocks\ntext_blocks = [b.text for b in response.content if b.type == \"text\"]\ntext = \"\\n\".join(text_blocks)\n```\n\n## Pitfall 5: Ignoring Stop Reason\n\n```python\n# WRONG — assuming response is always complete\ntext = msg.content[0].text  # Might be truncated!\n\n# CORRECT — check stop_reason\nif msg.stop_reason == \"max_tokens\":\n    print(\"WARNING: Response was truncated. Increase max_tokens.\")\nelif msg.stop_reason == \"tool_use\":\n    print(\"Claude wants to call a tool — process tool_use blocks\")\nelif msg.stop_reason == \"end_turn\":\n    print(\"Complete response\")\n```\n\n## Pitfall 6: Not Handling tool_use_id Properly\n\n```python\n# WRONG — fabricating tool_use_id\ntool_results = [{\"type\": \"tool_result\", \"tool_use_id\": \"some-id\", \"content\": \"...\"}]\n\n# CORRECT — use the exact ID from Claude's response\nfor block in response.content:\n    if block.type == \"tool_use\":\n        result = execute_tool(block.name, block.input)\n        tool_results.append({\n            \"type\": \"tool_result\",\n            \"tool_use_id\": block.id,  # Must match exactly\n            \"content\": result\n        })\n```\n\n## Pitfall 7: Hardcoding Model IDs Without Versioning\n\n```python\n# RISKY — model aliases may change behavior\nmodel = \"claude-3-5-sonnet\"  # Alias, might point to different version\n\n# BETTER — use dated version for reproducibility\nmodel = \"claude-sonnet-4-20250514\"  # Pinned version\n```\n\n## Pitfall 8: Not Using SDK Auto-Retry\n\n```python\n# UNNECESSARY — writing custom retry logic for 429\u002F5xx\nfor attempt in range(3):\n    try:\n        msg = client.messages.create(...)\n        break\n    except Exception:\n        time.sleep(2 ** attempt)\n\n# BETTER — SDK handles this automatically\nclient = anthropic.Anthropic(max_retries=5)  # Built-in exponential backoff\nmsg = client.messages.create(...)  # Auto-retries 429 and 5xx\n```\n\n## Pitfall 9: Inflated max_tokens\n\n```python\n# WASTEFUL — setting max_tokens higher than needed\n# Doesn't cost more tokens, but increases latency\nmsg = client.messages.create(\n    model=\"claude-sonnet-4-20250514\",\n    max_tokens=200000,  # Way more than needed for a classification\n    messages=[{\"role\": \"user\", \"content\": \"Classify: positive or negative?\"}]\n)\n\n# BETTER — right-size for the task\nmsg = client.messages.create(\n    model=\"claude-haiku-4-20250514\",  # Use Haiku for classification\n    max_tokens=16,  # Only need one word\n    messages=[{\"role\": \"user\", \"content\": \"Classify: positive or negative?\"}]\n)\n```\n\n## Pitfall 10: No Cost Tracking\n\n```python\n# Every response includes usage data — track it\nmsg = client.messages.create(...)\ncost = (msg.usage.input_tokens * 3.0 + msg.usage.output_tokens * 15.0) \u002F 1_000_000\n# Log cost per request to catch runaway spend early\n```\n\n## Quick Reference: Anthropic vs OpenAI Differences\n\n| Feature | OpenAI | Anthropic |\n|---------|--------|-----------|\n| `max_tokens` | Optional | **Required** |\n| System prompt | In messages array | `system` parameter |\n| Response text | `.choices[0].message.content` | `.content[0].text` |\n| Default import | Named export | Default export |\n| Auto-retry | No | Yes (configurable) |\n| Streaming | Yields chunks | SSE events |\n\n## Resources\n\n- [Messages API Reference](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fapi\u002Fmessages)\n- [Python SDK](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fanthropic-sdk-python)\n- [TypeScript SDK](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fanthropic-sdk-typescript)\n",{"name":5,"tags":24,"author":28,"license":15,"version":29,"description":30,"allowed-tools":31,"compatible-with":32},[25,26,27],"saas","ai","anthropic","Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Identify and avoid common Claude API anti-patterns and integration mistakes.\nUse when reviewing code, onboarding developers, or debugging subtle issues\nwith Anthropic integrations.\nTrigger with phrases like \"anthropic pitfalls\", \"claude anti-patterns\",\n\"claude mistakes\", \"anthropic common issues\", \"claude gotchas\".\n","Read, Write, Edit, Grep","claude-code","main","99825ad3f3bcc6597ddcc7294a14e6e922f2b67b","skills\u002Fsaas-packs--anthropic-pack--anth-known-pitfalls",0,"https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills","https:\u002F\u002Fgithub.com\u002Fjukeyman","https:\u002F\u002FRJBUSINESSSOLUTIONS.ORG","Credit and Finance Expert | Developer\r\n\r\nI'm Rick Jefferson, a seasoned credit and finance expert with over a decade of experience in financial literacy,","2026-07-13 07:03:29",{"source":8,"skillName":5,"commands":43,"prompt":53,"zipAvailable":54},[44,47,50],{"tool":45,"command":46},"npx","npx skills add jukeyman\u002Fjukeyman-skills --skill anth-known-pitfalls",{"tool":48,"command":49},"bunx","bunx skills add jukeyman\u002Fjukeyman-skills --skill anth-known-pitfalls",{"tool":51,"command":52},"pnpm","pnpm dlx skills add jukeyman\u002Fjukeyman-skills --skill anth-known-pitfalls","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--anthropic-pack--anth-known-pitfalls\u002FSKILL.md",true,[],[57,64,71,78,85,93],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M79ANS2SM329NEP5ZCX106RR","zustand-store-creator","Create zustand store creator operations. Auto-activating skill for Frontend Development.\nTriggers on: zustand store creator, zustand store creator\nPart of the Frontend Development skill category. Use when working with zustand store creator functionality. Trigger with phrases like \"zustand store creator\", \"zustand creator\", \"zustand\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzustand-store-creator\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M79AMZKP4YDEZ7EHG1Y7PP74","zero-trust-config-helper","Configure with zero trust config helper operations. Auto-activating skill for Security Advanced.\nTriggers on: zero trust config helper, zero trust config helper\nPart of the Security Advanced skill category. Use when configuring systems or services. Trigger with phrases like \"zero trust config helper\", \"zero helper\", \"zero\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzero-trust-config-helper\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M79AMJSBCEJQNBTYNAHYN5HM","zapier-integration-helper","Assist with zapier integration helper operations. Auto-activating skill for Business Automation.\nTriggers on: zapier integration helper, zapier integration helper\nPart of the Business Automation skill category. Use when working with APIs or building integrations. Trigger with phrases like \"zapier integration helper\", \"zapier helper\", \"zapier\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzapier-integration-helper\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M79AHJZGVMARS13VFQYRR1MP","yaml-config-validator","Validate yaml config validator operations. Auto-activating skill for DevOps Basics.\nTriggers on: yaml config validator, yaml config validator\nPart of the DevOps Basics skill category. Use when configuring systems or services. Trigger with phrases like \"yaml config validator\", \"yaml validator\", \"yaml\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fyaml-config-validator\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":89,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M79AHGDZRN0020RDQSQDPAM8","xvary-stock-research","Thesis-driven equity analysis from public SEC EDGAR and market data; \u002Fanalyze, \u002Fscore, \u002Fcompare workflows with bundled Python tools (Claude Code, Cursor, Codex).","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M79AHCYJ9FV9RMHQ24HDRN33","xss-vulnerability-scanner","Scan xss vulnerability scanner operations. Auto-activating skill for Security Fundamentals.\nTriggers on: xss vulnerability scanner, xss vulnerability scanner\nPart of the Security Fundamentals skill category. Use when working with xss vulnerability scanner functionality. Trigger with phrases like \"xss vulnerability scanner\", \"xss scanner\", \"xss\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxss-vulnerability-scanner\u002FSKILL.md",[],[]]