[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M752CYA2TE7YCN1MHCE9SF80":3,"skill-same:01M752CYA2TE7YCN1MHCE9SF80":49},{"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":29,"commitSha":30,"skillDirectory":5,"forksCount":14,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":33,"ownerDescription":6,"updatedAt":34,"install":35,"resources":48},"01M752CYA2TE7YCN1MHCE9SF80","langchain-common-errors",null,"Diagnose and fix common LangChain errors and exceptions.\nUse when encountering LangChain errors, debugging failures,\nor troubleshooting integration issues.\nTrigger with phrases like \"langchain error\", \"langchain exception\",\n\"debug langchain\", \"langchain not working\", \"langchain troubleshoot\".","SamuelChien\u002Fmega-skills-collection","SamuelChien","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F4652114?v=4","01M74KK34WVHA0P5ZYSJRDDFMG","Samuel Chien","01M74KK35FQN1N9VZ9EPTH3P2S",0,"MIT","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Flangchain-common-errors\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: langchain-common-errors\ndescription: |\n  Diagnose and fix common LangChain errors and exceptions.\n  Use when encountering LangChain errors, debugging failures,\n  or troubleshooting integration issues.\n  Trigger with phrases like \"langchain error\", \"langchain exception\",\n  \"debug langchain\", \"langchain not working\", \"langchain troubleshoot\".\nallowed-tools: Read, Write, Edit, Grep\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\ncompatible-with: claude-code, codex, openclaw\n---\n# LangChain Common Errors\n\n## Overview\nQuick reference for diagnosing and resolving the most common LangChain errors.\n\n## Prerequisites\n- LangChain installed and configured\n- Access to application logs\n- Understanding of your LangChain implementation\n\n## Error Reference\n\n### Authentication Errors\n\n#### `openai.AuthenticationError: Incorrect API key provided`\n```python\n# Cause: Invalid or missing API key\n# Solution:\nimport os\nos.environ[\"OPENAI_API_KEY\"] = \"sk-...\"  # Set correct key\n\n# Verify key is loaded\nfrom langchain_openai import ChatOpenAI\nllm = ChatOpenAI()  # Will raise error if key invalid\n```\n\n#### `anthropic.AuthenticationError: Invalid x-api-key`\n```python\n# Cause: Anthropic API key not set or invalid\n# Solution:\nos.environ[\"ANTHROPIC_API_KEY\"] = \"sk-ant-...\"\n\n# Or pass directly\nfrom langchain_anthropic import ChatAnthropic\nllm = ChatAnthropic(api_key=\"sk-ant-...\")\n```\n\n### Import Errors\n\n#### `ModuleNotFoundError: No module named 'langchain_openai'`\n```bash\nset -euo pipefail\n# Cause: Provider package not installed\n# Solution:\npip install langchain-openai\n\n# For other providers:\npip install langchain-anthropic\npip install langchain-google-genai\npip install langchain-community\n```\n\n#### `ImportError: cannot import name 'ChatOpenAI' from 'langchain'`\n```python\n# Cause: Using old import path (pre-0.2.0)\n# Old (deprecated):\nfrom langchain.chat_models import ChatOpenAI\n\n# New (correct):\nfrom langchain_openai import ChatOpenAI\n```\n\n### Rate Limiting\n\n#### `openai.RateLimitError: Rate limit reached`\n```python\n# Cause: Too many API requests\n# Solution: Implement retry with backoff\nfrom langchain_openai import ChatOpenAI\nfrom tenacity import retry, wait_exponential, stop_after_attempt\n\n@retry(wait=wait_exponential(min=1, max=60), stop=stop_after_attempt(5))\ndef call_with_retry(llm, prompt):\n    return llm.invoke(prompt)\n\n# Or use LangChain's built-in retry\nllm = ChatOpenAI(max_retries=3)\n```\n\n### Output Parsing Errors\n\n#### `OutputParserException: Failed to parse output`\n```python\n# Cause: LLM output doesn't match expected format\n# Solution 1: Use with_retry\nfrom langchain.output_parsers import RetryOutputParser\n\nparser = RetryOutputParser.from_llm(parser=your_parser, llm=llm)\n\n# Solution 2: Use structured output (more reliable)\nfrom pydantic import BaseModel\n\nclass Output(BaseModel):\n    answer: str\n\nllm_with_structure = llm.with_structured_output(Output)\n```\n\n#### `ValidationError: field required`\n```python\n# Cause: Pydantic model validation failed\n# Solution: Make fields optional or provide defaults\nfrom pydantic import BaseModel, Field\nfrom typing import Optional\n\nclass Output(BaseModel):\n    answer: str\n    confidence: Optional[float] = Field(default=None)\n```\n\n### Chain Errors\n\n#### `ValueError: Missing required input keys`\n```python\n# Cause: Input dict missing required variables\n# Debug:\nprompt = ChatPromptTemplate.from_template(\"Hello {name}, you are {age}\")\nprint(prompt.input_variables)  # ['name', 'age']\n\n# Solution: Provide all required keys\nchain.invoke({\"name\": \"Alice\", \"age\": 30})\n```\n\n#### `TypeError: Expected mapping type as input`\n```python\n# Cause: Passing wrong input type\n# Wrong:\nchain.invoke(\"hello\")\n\n# Correct:\nchain.invoke({\"input\": \"hello\"})\n```\n\n### Agent Errors\n\n#### `AgentExecutor: max iterations reached`\n```python\n# Cause: Agent stuck in loop\n# Solution: Increase iterations or improve prompts\nagent_executor = AgentExecutor(\n    agent=agent,\n    tools=tools,\n    max_iterations=20,  # Increase from default 15\n    early_stopping_method=\"force\"  # Force stop after max\n)\n```\n\n#### `ToolException: Tool execution failed`\n```python\n# Cause: Tool raised an exception\n# Solution: Add error handling in tool\n@tool\ndef my_tool(input: str) -> str:\n    \"\"\"Tool description.\"\"\"\n    try:\n        # Tool logic\n        return result\n    except Exception as e:\n        return f\"Tool error: {str(e)}\"\n```\n\n### Memory Errors\n\n#### `KeyError: 'chat_history'`\n```python\n# Cause: Memory key mismatch\n# Solution: Ensure consistent key names\nprompt = ChatPromptTemplate.from_messages([\n    MessagesPlaceholder(variable_name=\"chat_history\"),  # Match this\n    (\"human\", \"{input}\")\n])\n\n# When invoking:\nchain.invoke({\n    \"input\": \"hello\",\n    \"chat_history\": []  # Must match placeholder name\n})\n```\n\n## Debugging Tips\n\n### Enable Verbose Mode\n```python\nimport langchain\nlangchain.debug = True  # Shows all chain steps\n\n# Or per-component\nagent_executor = AgentExecutor(verbose=True)\n```\n\n### Trace with LangSmith\n```python\n# Set environment variables\nos.environ[\"LANGCHAIN_TRACING_V2\"] = \"true\"\nos.environ[\"LANGCHAIN_API_KEY\"] = \"your-langsmith-key\"\nos.environ[\"LANGCHAIN_PROJECT\"] = \"my-project\"\n\n# All chains automatically traced\n```\n\n### Check Version Compatibility\n```bash\nset -euo pipefail\npip show langchain langchain-core langchain-openai\n\n# Ensure versions are compatible:\n# langchain >= 0.3.0\n# langchain-core >= 0.3.0\n# langchain-openai >= 0.2.0\n```\n\n## Resources\n- [LangChain Troubleshooting](https:\u002F\u002Fpython.langchain.com\u002Fdocs\u002Ftroubleshooting\u002F)\n- [LangSmith Debugging](https:\u002F\u002Fdocs.smith.langchain.com\u002F)\n- [GitHub Issues](https:\u002F\u002Fgithub.com\u002Flangchain-ai\u002Flangchain\u002Fissues)\n\n## Next Steps\nFor complex debugging, use `langchain-debug-bundle` to collect evidence.\n\n## Instructions\n\n1. Assess the current state of the debugging configuration\n2. Identify the specific requirements and constraints\n3. Apply the recommended patterns from this skill\n4. Validate the changes against expected behavior\n5. Document the configuration for team reference\n\n## Output\n\n- Configuration files or code changes applied to the project\n- Validation report confirming correct implementation\n- Summary of changes made and their rationale\n\n## Error Handling\n\n| Error | Cause | Resolution |\n|-------|-------|------------|\n| Authentication failure | Invalid or expired credentials | Refresh tokens or re-authenticate with debugging |\n| Configuration conflict | Incompatible settings detected | Review and resolve conflicting parameters |\n| Resource not found | Referenced resource missing | Verify resource exists and permissions are correct |\n\n## Examples\n\n**Basic usage**: Apply langchain common errors to a standard project setup with default configuration options.\n\n**Advanced scenario**: Customize langchain common errors for production environments with multiple constraints and team-specific requirements.","# LangChain Common Errors\n\n## Overview\nQuick reference for diagnosing and resolving the most common LangChain errors.\n\n## Prerequisites\n- LangChain installed and configured\n- Access to application logs\n- Understanding of your LangChain implementation\n\n## Error Reference\n\n### Authentication Errors\n\n#### `openai.AuthenticationError: Incorrect API key provided`\n```python\n# Cause: Invalid or missing API key\n# Solution:\nimport os\nos.environ[\"OPENAI_API_KEY\"] = \"sk-...\"  # Set correct key\n\n# Verify key is loaded\nfrom langchain_openai import ChatOpenAI\nllm = ChatOpenAI()  # Will raise error if key invalid\n```\n\n#### `anthropic.AuthenticationError: Invalid x-api-key`\n```python\n# Cause: Anthropic API key not set or invalid\n# Solution:\nos.environ[\"ANTHROPIC_API_KEY\"] = \"sk-ant-...\"\n\n# Or pass directly\nfrom langchain_anthropic import ChatAnthropic\nllm = ChatAnthropic(api_key=\"sk-ant-...\")\n```\n\n### Import Errors\n\n#### `ModuleNotFoundError: No module named 'langchain_openai'`\n```bash\nset -euo pipefail\n# Cause: Provider package not installed\n# Solution:\npip install langchain-openai\n\n# For other providers:\npip install langchain-anthropic\npip install langchain-google-genai\npip install langchain-community\n```\n\n#### `ImportError: cannot import name 'ChatOpenAI' from 'langchain'`\n```python\n# Cause: Using old import path (pre-0.2.0)\n# Old (deprecated):\nfrom langchain.chat_models import ChatOpenAI\n\n# New (correct):\nfrom langchain_openai import ChatOpenAI\n```\n\n### Rate Limiting\n\n#### `openai.RateLimitError: Rate limit reached`\n```python\n# Cause: Too many API requests\n# Solution: Implement retry with backoff\nfrom langchain_openai import ChatOpenAI\nfrom tenacity import retry, wait_exponential, stop_after_attempt\n\n@retry(wait=wait_exponential(min=1, max=60), stop=stop_after_attempt(5))\ndef call_with_retry(llm, prompt):\n    return llm.invoke(prompt)\n\n# Or use LangChain's built-in retry\nllm = ChatOpenAI(max_retries=3)\n```\n\n### Output Parsing Errors\n\n#### `OutputParserException: Failed to parse output`\n```python\n# Cause: LLM output doesn't match expected format\n# Solution 1: Use with_retry\nfrom langchain.output_parsers import RetryOutputParser\n\nparser = RetryOutputParser.from_llm(parser=your_parser, llm=llm)\n\n# Solution 2: Use structured output (more reliable)\nfrom pydantic import BaseModel\n\nclass Output(BaseModel):\n    answer: str\n\nllm_with_structure = llm.with_structured_output(Output)\n```\n\n#### `ValidationError: field required`\n```python\n# Cause: Pydantic model validation failed\n# Solution: Make fields optional or provide defaults\nfrom pydantic import BaseModel, Field\nfrom typing import Optional\n\nclass Output(BaseModel):\n    answer: str\n    confidence: Optional[float] = Field(default=None)\n```\n\n### Chain Errors\n\n#### `ValueError: Missing required input keys`\n```python\n# Cause: Input dict missing required variables\n# Debug:\nprompt = ChatPromptTemplate.from_template(\"Hello {name}, you are {age}\")\nprint(prompt.input_variables)  # ['name', 'age']\n\n# Solution: Provide all required keys\nchain.invoke({\"name\": \"Alice\", \"age\": 30})\n```\n\n#### `TypeError: Expected mapping type as input`\n```python\n# Cause: Passing wrong input type\n# Wrong:\nchain.invoke(\"hello\")\n\n# Correct:\nchain.invoke({\"input\": \"hello\"})\n```\n\n### Agent Errors\n\n#### `AgentExecutor: max iterations reached`\n```python\n# Cause: Agent stuck in loop\n# Solution: Increase iterations or improve prompts\nagent_executor = AgentExecutor(\n    agent=agent,\n    tools=tools,\n    max_iterations=20,  # Increase from default 15\n    early_stopping_method=\"force\"  # Force stop after max\n)\n```\n\n#### `ToolException: Tool execution failed`\n```python\n# Cause: Tool raised an exception\n# Solution: Add error handling in tool\n@tool\ndef my_tool(input: str) -> str:\n    \"\"\"Tool description.\"\"\"\n    try:\n        # Tool logic\n        return result\n    except Exception as e:\n        return f\"Tool error: {str(e)}\"\n```\n\n### Memory Errors\n\n#### `KeyError: 'chat_history'`\n```python\n# Cause: Memory key mismatch\n# Solution: Ensure consistent key names\nprompt = ChatPromptTemplate.from_messages([\n    MessagesPlaceholder(variable_name=\"chat_history\"),  # Match this\n    (\"human\", \"{input}\")\n])\n\n# When invoking:\nchain.invoke({\n    \"input\": \"hello\",\n    \"chat_history\": []  # Must match placeholder name\n})\n```\n\n## Debugging Tips\n\n### Enable Verbose Mode\n```python\nimport langchain\nlangchain.debug = True  # Shows all chain steps\n\n# Or per-component\nagent_executor = AgentExecutor(verbose=True)\n```\n\n### Trace with LangSmith\n```python\n# Set environment variables\nos.environ[\"LANGCHAIN_TRACING_V2\"] = \"true\"\nos.environ[\"LANGCHAIN_API_KEY\"] = \"your-langsmith-key\"\nos.environ[\"LANGCHAIN_PROJECT\"] = \"my-project\"\n\n# All chains automatically traced\n```\n\n### Check Version Compatibility\n```bash\nset -euo pipefail\npip show langchain langchain-core langchain-openai\n\n# Ensure versions are compatible:\n# langchain >= 0.3.0\n# langchain-core >= 0.3.0\n# langchain-openai >= 0.2.0\n```\n\n## Resources\n- [LangChain Troubleshooting](https:\u002F\u002Fpython.langchain.com\u002Fdocs\u002Ftroubleshooting\u002F)\n- [LangSmith Debugging](https:\u002F\u002Fdocs.smith.langchain.com\u002F)\n- [GitHub Issues](https:\u002F\u002Fgithub.com\u002Flangchain-ai\u002Flangchain\u002Fissues)\n\n## Next Steps\nFor complex debugging, use `langchain-debug-bundle` to collect evidence.\n\n## Instructions\n\n1. Assess the current state of the debugging configuration\n2. Identify the specific requirements and constraints\n3. Apply the recommended patterns from this skill\n4. Validate the changes against expected behavior\n5. Document the configuration for team reference\n\n## Output\n\n- Configuration files or code changes applied to the project\n- Validation report confirming correct implementation\n- Summary of changes made and their rationale\n\n## Error Handling\n\n| Error | Cause | Resolution |\n|-------|-------|------------|\n| Authentication failure | Invalid or expired credentials | Refresh tokens or re-authenticate with debugging |\n| Configuration conflict | Incompatible settings detected | Review and resolve conflicting parameters |\n| Resource not found | Referenced resource missing | Verify resource exists and permissions are correct |\n\n## Examples\n\n**Basic usage**: Apply langchain common errors to a standard project setup with default configuration options.\n\n**Advanced scenario**: Customize langchain common errors for production environments with multiple constraints and team-specific requirements.",{"name":5,"author":24,"license":15,"version":25,"description":26,"allowed-tools":27,"compatible-with":28},"Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Diagnose and fix common LangChain errors and exceptions.\nUse when encountering LangChain errors, debugging failures,\nor troubleshooting integration issues.\nTrigger with phrases like \"langchain error\", \"langchain exception\",\n\"debug langchain\", \"langchain not working\", \"langchain troubleshoot\".\n","Read, Write, Edit, Grep","claude-code, codex, openclaw","main","c2b1fdccc779e99ac814e55fb69ca8d71215dd0f","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection","https:\u002F\u002Fgithub.com\u002FSamuelChien","http:\u002F\u002Fsamuelchien.com\u002F","2026-05-26 08:27:14",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add SamuelChien\u002Fmega-skills-collection --skill langchain-common-errors",{"tool":41,"command":42},"bunx","bunx skills add SamuelChien\u002Fmega-skills-collection --skill langchain-common-errors",{"tool":44,"command":45},"pnpm","pnpm dlx skills add SamuelChien\u002Fmega-skills-collection --skill langchain-common-errors","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Flangchain-common-errors\u002FSKILL.md",true,[],[50,57,64,71,78,86],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M76R4WZQZAXGGXMQCA0FZ716","zustand-store-ts","Create Zustand stores with TypeScript, subscribeWithSelector middleware, and proper state\u002Faction separation. Use when building React state management, creating global stores, or implementing reactive state patterns with Zustand.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fzustand-store-ts\u002FSKILL.md",[],[],{"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},"01M76R4T9KENDH7FENGZQHBW4G","zustand-store-creator","Zustand Store Creator - Auto-activating skill for Frontend Development.\nTriggers on: zustand store creator, zustand store creator\nPart of the Frontend Development skill category.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\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},"01M76R3YWN84B7SANJ52X799ZE","zero-trust-config-helper","Zero Trust Config Helper - Auto-activating skill for Security Advanced.\nTriggers on: zero trust config helper, zero trust config helper\nPart of the Security Advanced skill category.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\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},"01M76R3HNSV2AEYSKHM915GJ58","zapier-integration-helper","Zapier Integration Helper - Auto-activating skill for Business Automation.\nTriggers on: zapier integration helper, zapier integration helper\nPart of the Business Automation skill category.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\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":82,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M76R3DJSKAT4FA7DV4BF3GCE","zai-cli","Execute z.AI CLI providing vision, search, reader, and GitHub exploration via CLI and MCP.\nUse when user needs image\u002Fvideo analysis, OCR, UI-to-code conversion, error diagnosis,\nreal-time web search, web page to markdown extraction, or GitHub code exploration.\nTrigger with phrases like \"analyze this image\", \"search the web for\", \"read this page\",\n\"explore this repo\", or \"use zai\". Requires Z_AI_API_KEY.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fzai-cli\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M76R2KAM699XE9AJVAWE4H2E","yt-research","Research competitor YouTube channels, niches, and trending topics for your content strategy.\nUse this skill whenever the user says \"research channels\", \"analyze competitors\", \"find trending topics\",\n\"niche analysis\", \"competitive research\", \"what are other creators doing\", \"scrape YouTube channels\",\nor wants to understand the competitive landscape for a specific tool or topic area. Use when working with yt research. Trigger with 'yt', 'research'.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fyt-research\u002FSKILL.md",[],[]]