Skip to main content
Netra MCP solves this by providing a standardized interface for integrating observability into your workflows. Netra Skills bridge this gap by giving agents and developers ready-to-use patterns and primitives for reliable instrumentation. Instead of figuring everything out from scratch, you get a proven approach that works in real production environments.

​
Quick Start

You can add these skills to your local environment in seconds: 
npx skills add KeyValueSoftwareSystems/netra-skills
The CLI will detect which agentic interfaces you have installed and drop the instructions in the right place. Agents that support skills should start to use them automatically.

​
Available skills

SkillBest ForInstall command
netra-best-practicesEnd-to-end instrumentation, observability, and evaluation.npx skills add KeyValueSoftwareSystems/netra-skills --skill netra-best-practices
netra-mcp-usageMCP trace debugging focused on query and retrieval operations.npx skills add KeyValueSoftwareSystems/netra-skills --skill netra-mcp-usage

​
When To Use

  • You want one workflow that replaces separate setup and instrumentation skills.
  • You need traceability from request context to span-level debugging.
  • You need precise, schema-correct inputs for Netra MCP query and retrieval tools.
  • You need repeatable quality validation with evaluations and simulations.
  • You need production-safe troubleshooting guidance.

​
Coverage

  • Setup and Baseline: Initialize the SDK correctly for Python (FastAPI/OpenAI) and TypeScript (Express/OpenAI).
  • Context Tracking: Implement request identity (user_id, session_id, tenant_id) and conversation logging.
  • Trace Debugging: Execute precise query_traces and get_trace_by_id calls with correct schemas, sorting, and pagination.
  • Instrumentation Strategy: Choose between auto-instrumentation, decorators (@workflow, @agent, @task), and manual spans.
  • Advanced Observability: Implement usage/cost tracking, action records, and OpenTelemetry custom metrics.
  • Evaluation: Set up single-turn evaluations and multi-turn simulations with representative datasets.
  • Trace Analysis: Use Netra MCP tools (netra_query_traces, netra_get_trace_by_id) to debug regressions.
Last modified on March 26, 2026