[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6DAP3833NSHV58VQ8V4EMPM":3,"skill-same:01M6DAP3833NSHV58VQ8V4EMPM":70},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":27,"publishedAt":45,"linkOnly":46,"markdownContent":47,"markdownBody":48,"frontMatter":49,"refName":50,"commitSha":51,"skillDirectory":52,"forksCount":13,"repositoryHtmlUrl":53,"repositoryHomepageUrl":6,"ownerHtmlUrl":54,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":55,"install":56,"resources":69},"01M6DAP3833NSHV58VQ8V4EMPM","langsmith-fetch",null,"Debug LangChain and LangGraph agents by fetching execution traces from LangSmith Studio. Use when debugging agent behavior, investigating errors, analyzing tool calls, checking memory operations, or examining agent performance. Automatically fetches recent traces and analyzes execution patterns. Requires langsmith-fetch CLI installed.","tzeusy-org\u002Fai-bootstrap","tzeusy-org","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F141543652?v=4","01M6DAM1AP09H27BYGFY9QCNPB","01M6DAM1F4R187EK11XDN9JZKH",0,"MIT","https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Farchive\u002Flangsmith-fetch\u002FSKILL.md",[17,22],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",{"categoryNo":23,"categoryName":24,"taxonomyType":25,"taxonomyTypeDesc":26},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44],"fetch","langsmith fetch","tool","patterns","langgraph agents","use","operations","behavior","langchain","cli","execution","langgraph","analyzing","debugging","debug","performance","memory","2026-11-10 10:12:30",false,"---\nname: langsmith-fetch\ndescription: Debug LangChain and LangGraph agents by fetching execution traces from LangSmith Studio. Use when debugging agent behavior, investigating errors, analyzing tool calls, checking memory operations, or examining agent performance. Automatically fetches recent traces and analyzes execution patterns. Requires langsmith-fetch CLI installed.\n---\n\n# LangSmith Fetch - Agent Debugging Skill\n\nDebug LangChain and LangGraph agents by fetching execution traces directly from LangSmith Studio in your terminal.\n\n## When to Use This Skill\n\nAutomatically activate when user mentions:\n- ? \"Debug my agent\" or \"What went wrong?\"\n- ? \"Show me recent traces\" or \"What happened?\"\n- ❌ \"Check for errors\" or \"Why did it fail?\"\n- ? \"Analyze memory operations\" or \"Check LTM\"\n- ? \"Review agent performance\" or \"Check token usage\"\n- ? \"What tools were called?\" or \"Show execution flow\"\n\n## Prerequisites\n\n### 1. Install langsmith-fetch\n```bash\npip install langsmith-fetch\n```\n\n### 2. Set Environment Variables\n```bash\nexport LANGSMITH_API_KEY=\"your_langsmith_api_key\"\nexport LANGSMITH_PROJECT=\"your_project_name\"\n```\n\n**Verify setup:**\n```bash\necho $LANGSMITH_API_KEY\necho $LANGSMITH_PROJECT\n```\n\n## Core Workflows\n\n### Workflow 1: Quick Debug Recent Activity\n\n**When user asks:** \"What just happened?\" or \"Debug my agent\"\n\n**Execute:**\n```bash\nlangsmith-fetch traces --last-n-minutes 5 --limit 5 --format pretty\n```\n\n**Analyze and report:**\n1. ✅ Number of traces found\n2. ⚠️ Any errors or failures\n3. ?️ Tools that were called\n4. ⏱️ Execution times\n5. ? Token usage\n\n**Example response format:**\n```\nFound 3 traces in the last 5 minutes:\n\nTrace 1: ✅ Success\n- Agent: memento\n- Tools: recall_memories, create_entities\n- Duration: 2.3s\n- Tokens: 1,245\n\nTrace 2: ❌ Error\n- Agent: cypher\n- Error: \"Neo4j connection timeout\"\n- Duration: 15.1s\n- Failed at: search_nodes tool\n\nTrace 3: ✅ Success\n- Agent: memento\n- Tools: store_memory\n- Duration: 1.8s\n- Tokens: 892\n\n? Issue found: Trace 2 failed due to Neo4j timeout. Recommend checking database connection.\n```\n\n---\n\n### Workflow 2: Deep Dive Specific Trace\n\n**When user provides:** Trace ID or says \"investigate that error\"\n\n**Execute:**\n```bash\nlangsmith-fetch trace \u003Ctrace-id> --format json\n```\n\n**Analyze JSON and report:**\n1. ? What the agent was trying to do\n2. ?️ Which tools were called (in order)\n3. ✅ Tool results (success\u002Ffailure)\n4. ❌ Error messages (if any)\n5. ? Root cause analysis\n6. ? Suggested fix\n\n**Example response format:**\n```\nDeep Dive Analysis - Trace abc123\n\nGoal: User asked \"Find all projects in Neo4j\"\n\nExecution Flow:\n1. ✅ search_nodes(query: \"projects\")\n   → Found 24 nodes\n\n2. ❌ get_node_details(node_id: \"proj_123\")\n   → Error: \"Node not found\"\n   → This is the failure point\n\n3. ⏹️ Execution stopped\n\nRoot Cause:\nThe search_nodes tool returned node IDs that no longer exist in the database,\npossibly due to recent deletions.\n\nSuggested Fix:\n1. Add error handling in get_node_details tool\n2. Filter deleted nodes in search results\n3. Update cache invalidation strategy\n\nToken Usage: 1,842 tokens ($0.0276)\nExecution Time: 8.7 seconds\n```\n\n---\n\n### Workflow 3: Export Debug Session\n\n**When user says:** \"Save this session\" or \"Export traces\"\n\n**Execute:**\n```bash\n# Create session folder with timestamp\nSESSION_DIR=\"langsmith-debug\u002Fsession-$(date +%Y%m%d-%H%M%S)\"\nmkdir -p \"$SESSION_DIR\"\n\n# Export traces\nlangsmith-fetch traces \"$SESSION_DIR\u002Ftraces\" --last-n-minutes 30 --limit 50 --include-metadata\n\n# Export threads (conversations)\nlangsmith-fetch threads \"$SESSION_DIR\u002Fthreads\" --limit 20\n```\n\n**Report:**\n```\n✅ Session exported successfully!\n\nLocation: langsmith-debug\u002Fsession-20251224-143022\u002F\n- Traces: 42 files\n- Threads: 8 files\n\nYou can now:\n1. Review individual trace files\n2. Share folder with team\n3. Analyze with external tools\n4. Archive for future reference\n\nSession size: 2.3 MB\n```\n\n---\n\n### Workflow 4: Error Detection\n\n**When user asks:** \"Show me errors\" or \"What's failing?\"\n\n**Execute:**\n```bash\n# Fetch recent traces\nlangsmith-fetch traces --last-n-minutes 30 --limit 50 --format json > recent-traces.json\n\n# Search for errors\ngrep -i \"error\\|failed\\|exception\" recent-traces.json\n```\n\n**Analyze and report:**\n1. ? Total errors found\n2. ❌ Error types and frequency\n3. ? When errors occurred\n4. ? Which agents\u002Ftools failed\n5. ? Common patterns\n\n**Example response format:**\n```\nError Analysis - Last 30 Minutes\n\nTotal Traces: 50\nFailed Traces: 7 (14% failure rate)\n\nError Breakdown:\n1. Neo4j Connection Timeout (4 occurrences)\n   - Agent: cypher\n   - Tool: search_nodes\n   - First occurred: 14:32\n   - Last occurred: 14:45\n   - Pattern: Happens during peak load\n\n2. Memory Store Failed (2 occurrences)\n   - Agent: memento\n   - Tool: store_memory\n   - Error: \"Pinecone rate limit exceeded\"\n   - Occurred: 14:38, 14:41\n\n3. Tool Not Found (1 occurrence)\n   - Agent: sqlcrm\n   - Attempted tool: \"export_report\" (doesn't exist)\n   - Occurred: 14:35\n\n? Recommendations:\n1. Add retry logic for Neo4j timeouts\n2. Implement rate limiting for Pinecone\n3. Fix sqlcrm tool configuration\n```\n\n---\n\n## Common Use Cases\n\n### Use Case 1: \"Agent Not Responding\"\n\n**User says:** \"My agent isn't doing anything\"\n\n**Steps:**\n1. Check if traces exist:\n   ```bash\n   langsmith-fetch traces --last-n-minutes 5 --limit 5\n   ```\n\n2. **If NO traces found:**\n   - Tracing might be disabled\n   - Check: `LANGCHAIN_TRACING_V2=true` in environment\n   - Check: `LANGCHAIN_API_KEY` is set\n   - Verify agent actually ran\n\n3. **If traces found:**\n   - Review for errors\n   - Check execution time (hanging?)\n   - Verify tool calls completed\n\n---\n\n### Use Case 2: \"Wrong Tool Called\"\n\n**User says:** \"Why did it use the wrong tool?\"\n\n**Steps:**\n1. Get the specific trace\n2. Review available tools at execution time\n3. Check agent's reasoning for tool selection\n4. Examine tool descriptions\u002Finstructions\n5. Suggest prompt or tool config improvements\n\n---\n\n### Use Case 3: \"Memory Not Working\"\n\n**User says:** \"Agent doesn't remember things\"\n\n**Steps:**\n1. Search for memory operations:\n   ```bash\n   langsmith-fetch traces --last-n-minutes 10 --limit 20 --format raw | grep -i \"memory\\|recall\\|store\"\n   ```\n\n2. Check:\n   - Were memory tools called?\n   - Did recall return results?\n   - Were memories actually stored?\n   - Are retrieved memories being used?\n\n---\n\n### Use Case 4: \"Performance Issues\"\n\n**User says:** \"Agent is too slow\"\n\n**Steps:**\n1. Export with metadata:\n   ```bash\n   langsmith-fetch traces .\u002Fperf-analysis --last-n-minutes 30 --limit 50 --include-metadata\n   ```\n\n2. Analyze:\n   - Execution time per trace\n   - Tool call latencies\n   - Token usage (context size)\n   - Number of iterations\n   - Slowest operations\n\n3. Identify bottlenecks and suggest optimizations\n\n---\n\n## Output Format Guide\n\n### Pretty Format (Default)\n```bash\nlangsmith-fetch traces --limit 5 --format pretty\n```\n**Use for:** Quick visual inspection, showing to users\n\n### JSON Format\n```bash\nlangsmith-fetch traces --limit 5 --format json\n```\n**Use for:** Detailed analysis, syntax-highlighted review\n\n### Raw Format\n```bash\nlangsmith-fetch traces --limit 5 --format raw\n```\n**Use for:** Piping to other commands, automation\n\n---\n\n## Advanced Features\n\n### Time-Based Filtering\n```bash\n# After specific timestamp\nlangsmith-fetch traces --after \"2025-12-24T13:00:00Z\" --limit 20\n\n# Last N minutes (most common)\nlangsmith-fetch traces --last-n-minutes 60 --limit 100\n```\n\n### Include Metadata\n```bash\n# Get extra context\nlangsmith-fetch traces --limit 10 --include-metadata\n\n# Metadata includes: agent type, model, tags, environment\n```\n\n### Concurrent Fetching (Faster)\n```bash\n# Speed up large exports\nlangsmith-fetch traces .\u002Foutput --limit 100 --concurrent 10\n```\n\n---\n\n## Troubleshooting\n\n### \"No traces found matching criteria\"\n\n**Possible causes:**\n1. No agent activity in the timeframe\n2. Tracing is disabled\n3. Wrong project name\n4. API key issues\n\n**Solutions:**\n```bash\n# 1. Try longer timeframe\nlangsmith-fetch traces --last-n-minutes 1440 --limit 50\n\n# 2. Check environment\necho $LANGSMITH_API_KEY\necho $LANGSMITH_PROJECT\n\n# 3. Try fetching threads instead\nlangsmith-fetch threads --limit 10\n\n# 4. Verify tracing is enabled in your code\n# Check for: LANGCHAIN_TRACING_V2=true\n```\n\n### \"Project not found\"\n\n**Solution:**\n```bash\n# View current config\nlangsmith-fetch config show\n\n# Set correct project\nexport LANGSMITH_PROJECT=\"correct-project-name\"\n\n# Or configure permanently\nlangsmith-fetch config set project \"your-project-name\"\n```\n\n### Environment variables not persisting\n\n**Solution:**\n```bash\n# Add to shell config file (~\u002F.bashrc or ~\u002F.zshrc)\necho 'export LANGSMITH_API_KEY=\"your_key\"' >> ~\u002F.bashrc\necho 'export LANGSMITH_PROJECT=\"your_project\"' >> ~\u002F.bashrc\n\n# Reload shell config\nsource ~\u002F.bashrc\n```\n\n---\n\n## Best Practices\n\n### 1. Regular Health Checks\n```bash\n# Quick check after making changes\nlangsmith-fetch traces --last-n-minutes 5 --limit 5\n```\n\n### 2. Organized Storage\n```\nlangsmith-debug\u002F\n├── sessions\u002F\n│   ├── 2025-12-24\u002F\n│   └── 2025-12-25\u002F\n├── error-cases\u002F\n└── performance-tests\u002F\n```\n\n### 3. Document Findings\nWhen you find bugs:\n1. Export the problematic trace\n2. Save to `error-cases\u002F` folder\n3. Note what went wrong in a README\n4. Share trace ID with team\n\n### 4. Integration with Development\n```bash\n# Before committing code\nlangsmith-fetch traces --last-n-minutes 10 --limit 5\n\n# If errors found\nlangsmith-fetch trace \u003Cerror-id> --format json > pre-commit-error.json\n```\n\n---\n\n## Quick Reference\n\n```bash\n# Most common commands\n\n# Quick debug\nlangsmith-fetch traces --last-n-minutes 5 --limit 5 --format pretty\n\n# Specific trace\nlangsmith-fetch trace \u003Ctrace-id> --format pretty\n\n# Export session\nlangsmith-fetch traces .\u002Fdebug-session --last-n-minutes 30 --limit 50\n\n# Find errors\nlangsmith-fetch traces --last-n-minutes 30 --limit 50 --format raw | grep -i error\n\n# With metadata\nlangsmith-fetch traces --limit 10 --include-metadata\n```\n\n---\n\n## Resources\n\n- **LangSmith Fetch CLI:** https:\u002F\u002Fgithub.com\u002Flangchain-ai\u002Flangsmith-fetch\n- **LangSmith Studio:** https:\u002F\u002Fsmith.langchain.com\u002F\n- **LangChain Docs:** https:\u002F\u002Fdocs.langchain.com\u002F\n- **This Skill Repo:** https:\u002F\u002Fgithub.com\u002FOthmanAdi\u002Flangsmith-fetch-skill\n\n---\n\n## Notes for Claude\n\n- Always check if `langsmith-fetch` is installed before running commands\n- Verify environment variables are set\n- Use `--format pretty` for human-readable output\n- Use `--format json` when you need to parse and analyze data\n- When exporting sessions, create organized folder structures\n- Always provide clear analysis and actionable insights\n- If commands fail, help troubleshoot configuration issues\n\n---\n\n**Version:** 0.1.0\n**Author:** Ahmad Othman Ammar Adi\n**License:** MIT\n**Repository:** https:\u002F\u002Fgithub.com\u002FOthmanAdi\u002Flangsmith-fetch-skill\n","# LangSmith Fetch - Agent Debugging Skill\n\nDebug LangChain and LangGraph agents by fetching execution traces directly from LangSmith Studio in your terminal.\n\n## When to Use This Skill\n\nAutomatically activate when user mentions:\n- ? \"Debug my agent\" or \"What went wrong?\"\n- ? \"Show me recent traces\" or \"What happened?\"\n- ❌ \"Check for errors\" or \"Why did it fail?\"\n- ? \"Analyze memory operations\" or \"Check LTM\"\n- ? \"Review agent performance\" or \"Check token usage\"\n- ? \"What tools were called?\" or \"Show execution flow\"\n\n## Prerequisites\n\n### 1. Install langsmith-fetch\n```bash\npip install langsmith-fetch\n```\n\n### 2. Set Environment Variables\n```bash\nexport LANGSMITH_API_KEY=\"your_langsmith_api_key\"\nexport LANGSMITH_PROJECT=\"your_project_name\"\n```\n\n**Verify setup:**\n```bash\necho $LANGSMITH_API_KEY\necho $LANGSMITH_PROJECT\n```\n\n## Core Workflows\n\n### Workflow 1: Quick Debug Recent Activity\n\n**When user asks:** \"What just happened?\" or \"Debug my agent\"\n\n**Execute:**\n```bash\nlangsmith-fetch traces --last-n-minutes 5 --limit 5 --format pretty\n```\n\n**Analyze and report:**\n1. ✅ Number of traces found\n2. ⚠️ Any errors or failures\n3. ?️ Tools that were called\n4. ⏱️ Execution times\n5. ? Token usage\n\n**Example response format:**\n```\nFound 3 traces in the last 5 minutes:\n\nTrace 1: ✅ Success\n- Agent: memento\n- Tools: recall_memories, create_entities\n- Duration: 2.3s\n- Tokens: 1,245\n\nTrace 2: ❌ Error\n- Agent: cypher\n- Error: \"Neo4j connection timeout\"\n- Duration: 15.1s\n- Failed at: search_nodes tool\n\nTrace 3: ✅ Success\n- Agent: memento\n- Tools: store_memory\n- Duration: 1.8s\n- Tokens: 892\n\n? Issue found: Trace 2 failed due to Neo4j timeout. Recommend checking database connection.\n```\n\n---\n\n### Workflow 2: Deep Dive Specific Trace\n\n**When user provides:** Trace ID or says \"investigate that error\"\n\n**Execute:**\n```bash\nlangsmith-fetch trace \u003Ctrace-id> --format json\n```\n\n**Analyze JSON and report:**\n1. ? What the agent was trying to do\n2. ?️ Which tools were called (in order)\n3. ✅ Tool results (success\u002Ffailure)\n4. ❌ Error messages (if any)\n5. ? Root cause analysis\n6. ? Suggested fix\n\n**Example response format:**\n```\nDeep Dive Analysis - Trace abc123\n\nGoal: User asked \"Find all projects in Neo4j\"\n\nExecution Flow:\n1. ✅ search_nodes(query: \"projects\")\n   → Found 24 nodes\n\n2. ❌ get_node_details(node_id: \"proj_123\")\n   → Error: \"Node not found\"\n   → This is the failure point\n\n3. ⏹️ Execution stopped\n\nRoot Cause:\nThe search_nodes tool returned node IDs that no longer exist in the database,\npossibly due to recent deletions.\n\nSuggested Fix:\n1. Add error handling in get_node_details tool\n2. Filter deleted nodes in search results\n3. Update cache invalidation strategy\n\nToken Usage: 1,842 tokens ($0.0276)\nExecution Time: 8.7 seconds\n```\n\n---\n\n### Workflow 3: Export Debug Session\n\n**When user says:** \"Save this session\" or \"Export traces\"\n\n**Execute:**\n```bash\n# Create session folder with timestamp\nSESSION_DIR=\"langsmith-debug\u002Fsession-$(date +%Y%m%d-%H%M%S)\"\nmkdir -p \"$SESSION_DIR\"\n\n# Export traces\nlangsmith-fetch traces \"$SESSION_DIR\u002Ftraces\" --last-n-minutes 30 --limit 50 --include-metadata\n\n# Export threads (conversations)\nlangsmith-fetch threads \"$SESSION_DIR\u002Fthreads\" --limit 20\n```\n\n**Report:**\n```\n✅ Session exported successfully!\n\nLocation: langsmith-debug\u002Fsession-20251224-143022\u002F\n- Traces: 42 files\n- Threads: 8 files\n\nYou can now:\n1. Review individual trace files\n2. Share folder with team\n3. Analyze with external tools\n4. Archive for future reference\n\nSession size: 2.3 MB\n```\n\n---\n\n### Workflow 4: Error Detection\n\n**When user asks:** \"Show me errors\" or \"What's failing?\"\n\n**Execute:**\n```bash\n# Fetch recent traces\nlangsmith-fetch traces --last-n-minutes 30 --limit 50 --format json > recent-traces.json\n\n# Search for errors\ngrep -i \"error\\|failed\\|exception\" recent-traces.json\n```\n\n**Analyze and report:**\n1. ? Total errors found\n2. ❌ Error types and frequency\n3. ? When errors occurred\n4. ? Which agents\u002Ftools failed\n5. ? Common patterns\n\n**Example response format:**\n```\nError Analysis - Last 30 Minutes\n\nTotal Traces: 50\nFailed Traces: 7 (14% failure rate)\n\nError Breakdown:\n1. Neo4j Connection Timeout (4 occurrences)\n   - Agent: cypher\n   - Tool: search_nodes\n   - First occurred: 14:32\n   - Last occurred: 14:45\n   - Pattern: Happens during peak load\n\n2. Memory Store Failed (2 occurrences)\n   - Agent: memento\n   - Tool: store_memory\n   - Error: \"Pinecone rate limit exceeded\"\n   - Occurred: 14:38, 14:41\n\n3. Tool Not Found (1 occurrence)\n   - Agent: sqlcrm\n   - Attempted tool: \"export_report\" (doesn't exist)\n   - Occurred: 14:35\n\n? Recommendations:\n1. Add retry logic for Neo4j timeouts\n2. Implement rate limiting for Pinecone\n3. Fix sqlcrm tool configuration\n```\n\n---\n\n## Common Use Cases\n\n### Use Case 1: \"Agent Not Responding\"\n\n**User says:** \"My agent isn't doing anything\"\n\n**Steps:**\n1. Check if traces exist:\n   ```bash\n   langsmith-fetch traces --last-n-minutes 5 --limit 5\n   ```\n\n2. **If NO traces found:**\n   - Tracing might be disabled\n   - Check: `LANGCHAIN_TRACING_V2=true` in environment\n   - Check: `LANGCHAIN_API_KEY` is set\n   - Verify agent actually ran\n\n3. **If traces found:**\n   - Review for errors\n   - Check execution time (hanging?)\n   - Verify tool calls completed\n\n---\n\n### Use Case 2: \"Wrong Tool Called\"\n\n**User says:** \"Why did it use the wrong tool?\"\n\n**Steps:**\n1. Get the specific trace\n2. Review available tools at execution time\n3. Check agent's reasoning for tool selection\n4. Examine tool descriptions\u002Finstructions\n5. Suggest prompt or tool config improvements\n\n---\n\n### Use Case 3: \"Memory Not Working\"\n\n**User says:** \"Agent doesn't remember things\"\n\n**Steps:**\n1. Search for memory operations:\n   ```bash\n   langsmith-fetch traces --last-n-minutes 10 --limit 20 --format raw | grep -i \"memory\\|recall\\|store\"\n   ```\n\n2. Check:\n   - Were memory tools called?\n   - Did recall return results?\n   - Were memories actually stored?\n   - Are retrieved memories being used?\n\n---\n\n### Use Case 4: \"Performance Issues\"\n\n**User says:** \"Agent is too slow\"\n\n**Steps:**\n1. Export with metadata:\n   ```bash\n   langsmith-fetch traces .\u002Fperf-analysis --last-n-minutes 30 --limit 50 --include-metadata\n   ```\n\n2. Analyze:\n   - Execution time per trace\n   - Tool call latencies\n   - Token usage (context size)\n   - Number of iterations\n   - Slowest operations\n\n3. Identify bottlenecks and suggest optimizations\n\n---\n\n## Output Format Guide\n\n### Pretty Format (Default)\n```bash\nlangsmith-fetch traces --limit 5 --format pretty\n```\n**Use for:** Quick visual inspection, showing to users\n\n### JSON Format\n```bash\nlangsmith-fetch traces --limit 5 --format json\n```\n**Use for:** Detailed analysis, syntax-highlighted review\n\n### Raw Format\n```bash\nlangsmith-fetch traces --limit 5 --format raw\n```\n**Use for:** Piping to other commands, automation\n\n---\n\n## Advanced Features\n\n### Time-Based Filtering\n```bash\n# After specific timestamp\nlangsmith-fetch traces --after \"2025-12-24T13:00:00Z\" --limit 20\n\n# Last N minutes (most common)\nlangsmith-fetch traces --last-n-minutes 60 --limit 100\n```\n\n### Include Metadata\n```bash\n# Get extra context\nlangsmith-fetch traces --limit 10 --include-metadata\n\n# Metadata includes: agent type, model, tags, environment\n```\n\n### Concurrent Fetching (Faster)\n```bash\n# Speed up large exports\nlangsmith-fetch traces .\u002Foutput --limit 100 --concurrent 10\n```\n\n---\n\n## Troubleshooting\n\n### \"No traces found matching criteria\"\n\n**Possible causes:**\n1. No agent activity in the timeframe\n2. Tracing is disabled\n3. Wrong project name\n4. API key issues\n\n**Solutions:**\n```bash\n# 1. Try longer timeframe\nlangsmith-fetch traces --last-n-minutes 1440 --limit 50\n\n# 2. Check environment\necho $LANGSMITH_API_KEY\necho $LANGSMITH_PROJECT\n\n# 3. Try fetching threads instead\nlangsmith-fetch threads --limit 10\n\n# 4. Verify tracing is enabled in your code\n# Check for: LANGCHAIN_TRACING_V2=true\n```\n\n### \"Project not found\"\n\n**Solution:**\n```bash\n# View current config\nlangsmith-fetch config show\n\n# Set correct project\nexport LANGSMITH_PROJECT=\"correct-project-name\"\n\n# Or configure permanently\nlangsmith-fetch config set project \"your-project-name\"\n```\n\n### Environment variables not persisting\n\n**Solution:**\n```bash\n# Add to shell config file (~\u002F.bashrc or ~\u002F.zshrc)\necho 'export LANGSMITH_API_KEY=\"your_key\"' >> ~\u002F.bashrc\necho 'export LANGSMITH_PROJECT=\"your_project\"' >> ~\u002F.bashrc\n\n# Reload shell config\nsource ~\u002F.bashrc\n```\n\n---\n\n## Best Practices\n\n### 1. Regular Health Checks\n```bash\n# Quick check after making changes\nlangsmith-fetch traces --last-n-minutes 5 --limit 5\n```\n\n### 2. Organized Storage\n```\nlangsmith-debug\u002F\n├── sessions\u002F\n│   ├── 2025-12-24\u002F\n│   └── 2025-12-25\u002F\n├── error-cases\u002F\n└── performance-tests\u002F\n```\n\n### 3. Document Findings\nWhen you find bugs:\n1. Export the problematic trace\n2. Save to `error-cases\u002F` folder\n3. Note what went wrong in a README\n4. Share trace ID with team\n\n### 4. Integration with Development\n```bash\n# Before committing code\nlangsmith-fetch traces --last-n-minutes 10 --limit 5\n\n# If errors found\nlangsmith-fetch trace \u003Cerror-id> --format json > pre-commit-error.json\n```\n\n---\n\n## Quick Reference\n\n```bash\n# Most common commands\n\n# Quick debug\nlangsmith-fetch traces --last-n-minutes 5 --limit 5 --format pretty\n\n# Specific trace\nlangsmith-fetch trace \u003Ctrace-id> --format pretty\n\n# Export session\nlangsmith-fetch traces .\u002Fdebug-session --last-n-minutes 30 --limit 50\n\n# Find errors\nlangsmith-fetch traces --last-n-minutes 30 --limit 50 --format raw | grep -i error\n\n# With metadata\nlangsmith-fetch traces --limit 10 --include-metadata\n```\n\n---\n\n## Resources\n\n- **LangSmith Fetch CLI:** https:\u002F\u002Fgithub.com\u002Flangchain-ai\u002Flangsmith-fetch\n- **LangSmith Studio:** https:\u002F\u002Fsmith.langchain.com\u002F\n- **LangChain Docs:** https:\u002F\u002Fdocs.langchain.com\u002F\n- **This Skill Repo:** https:\u002F\u002Fgithub.com\u002FOthmanAdi\u002Flangsmith-fetch-skill\n\n---\n\n## Notes for Claude\n\n- Always check if `langsmith-fetch` is installed before running commands\n- Verify environment variables are set\n- Use `--format pretty` for human-readable output\n- Use `--format json` when you need to parse and analyze data\n- When exporting sessions, create organized folder structures\n- Always provide clear analysis and actionable insights\n- If commands fail, help troubleshoot configuration issues\n\n---\n\n**Version:** 0.1.0\n**Author:** Ahmad Othman Ammar Adi\n**License:** MIT\n**Repository:** https:\u002F\u002Fgithub.com\u002FOthmanAdi\u002Flangsmith-fetch-skill\n",{"name":5,"description":7},"main","c907d6f0bf96bd61b936e8972e0f1c66ebb8148c","skills\u002Farchive\u002Flangsmith-fetch","https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap","https:\u002F\u002Fgithub.com\u002Ftzeusy-org","2026-11-10 23:17:25",{"source":8,"skillName":5,"commands":57,"prompt":67,"zipAvailable":68},[58,61,64],{"tool":59,"command":60},"npx","npx skills add tzeusy-org\u002Fai-bootstrap --skill langsmith-fetch",{"tool":62,"command":63},"bunx","bunx skills add tzeusy-org\u002Fai-bootstrap --skill langsmith-fetch",{"tool":65,"command":66},"pnpm","pnpm dlx skills add tzeusy-org\u002Fai-bootstrap --skill langsmith-fetch","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Farchive\u002Flangsmith-fetch\u002FSKILL.md",true,[],[71,97,118,133,152,163],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":45},"01M6DAZD21TWH2ET70V9FF75CQ","user-run","Use when a step needs privileges this session lacks (docker, sudo, another user's checkout or secrets, host access) and the owner must run it as tze. Writes a reviewable \u002Fhome\u002Forca\u002F.tmp\u002F\u003Cslug>\u002Frun.sh that impersonates tze (USER_TO_IMPERSONATE overrides), tees timestamped logs plus latest.log and collects artifacts there; Claude presents it with a risk and time brief, then continues from the logs. Triggers: \"I'll run it for you\", \"permission denied on docker.sock\", \"needs sudo\", \"sudo: a password is required\", \"run as tze\", \"\u002Fuser-run\".","https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fuser-run\u002FSKILL.md",[],[78,79,80,81,82,33,83,84,85,86,87,88,89,90,91,92,93,94,95,96],"user run","user","run","docker","logs","host","as","triggers","permission","active","time","log","artifacts","session","password","access","secrets","risk","brief",{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":107,"publishedAt":45},"01M6DAZAHTCBAD2WF0GAHWPST8","requesting-code-review","Use when completing tasks, implementing major features, or before merging to verify work meets requirements","https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fth-workflow\u002Fsubskills\u002Frequesting-code-review\u002FSKILL.md",[103,106],{"categoryNo":104,"categoryName":105,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000007","代码审查",{"categoryNo":23,"categoryName":24,"taxonomyType":25,"taxonomyTypeDesc":26},[108,109,110,111,112,113,87,114,115,33,116,117],"requesting code review","code","review","code review","work","requirements","upstream","superpowers","verify","tasks",{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":122,"categories":123,"keywords":126,"publishedAt":45},"01M6DAZ7CJ82D81XZB2YHVVY48","receiving-code-review","Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation","https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fth-workflow\u002Fsubskills\u002Freceiving-code-review\u002FSKILL.md",[124,125],{"categoryNo":104,"categoryName":105,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":23,"categoryName":24,"taxonomyType":25,"taxonomyTypeDesc":26},[127,109,110,111,87,114,128,115,33,129,130,131,132],"receiving code review","implementation","code review feedback","technical","feedback","verification",{"skillNo":134,"name":135,"nameZh":6,"description":136,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":137,"categories":138,"keywords":139,"publishedAt":45},"01M6DAZ4ER76ADXJ9KRFP7V3Q9","finishing-a-development-branch","Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup","https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fth-workflow\u002Fsubskills\u002Ffinishing-a-development-branch\u002FSKILL.md",[],[140,141,142,143,33,144,112,145,146,147,115,148,149,150,87,114,151,128],"branch","development","finishing a development branch","integrate","decide","how","cleanup","pr","merge","tests","structured","options",{"skillNo":153,"name":154,"nameZh":6,"description":155,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":156,"categories":157,"keywords":158,"publishedAt":45},"01M6DAYZFWWW2YPKP89QNQR96H","executing-plans","Use when you have a written implementation plan to execute in a separate session with review checkpoints","https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fth-workflow\u002Fsubskills\u002Fexecuting-plans\u002FSKILL.md",[],[159,160,161,110,162,87,114,128,115,33,91],"plans","executing plans","plan","execute",{"skillNo":164,"name":165,"nameZh":6,"description":166,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":167,"categories":168,"keywords":169,"publishedAt":45},"01M6DAYWM2YQHYCK7C35K1D29J","dispatching-parallel-agents","Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies","https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fth-workflow\u002Fsubskills\u002Fdispatching-parallel-agents\u002FSKILL.md",[],[170,171,172,33,115,114,173,87,174,117,175],"parallel agents","parallel","dispatching parallel agents","state","dependencies","shared"]