{
  "markdown": "# Agent Skills\n\nA collection of skills for AI coding agents. Skills are packaged instructions and scripts that extend agent capabilities.\n\nSkills follow the [Agent Skills](https://agentskills.io/) format.\n\n## Available Skills\n\n### logging-best-practices\n\nLogging best practices focused on wide events (canonical log lines). Contains guidelines for effective logging that enables powerful debugging and analytics.\n\n**Use when:**\n- Writing or reviewing logging code\n- Adding console.log, logger.info, or similar\n- Designing logging strategy for new services\n- Setting up logging infrastructure\n\n**Key concepts:**\n- Wide Events (Critical) - One context-rich event per request per service\n- High Cardinality & Dimensionality (Critical) - Many fields, unique identifiers\n- Business Context (Critical) - User subscription, cart value, feature flags\n- Environment Context (Critical) - Commit hash, version, region, instance ID\n- Single Logger (High) - One logger instance, configured at startup\n- Middleware Pattern (High) - Infrastructure in middleware, business context in handlers\n\n**References:**\n- [Logging Sucks](https://loggingsucks.com)\n- [Observability Wide Events 101](https://boristane.com/blog/observability-wide-events-101/)\n- [Stripe - Canonical Log Lines](https://stripe.com/blog/canonical-log-lines)\n\n## Installation\n\n```bash\nnpx add-skill boristane/agent-skills\n```\n\n## Usage\n\nSkills are automatically available once installed. The agent will use them when relevant tasks are detected.\n\n**Examples:**\n```\nAdd logging to this endpoint\n```\n```\nReview my logging code\n```\n```\nHelp me set up logging for this service\n```\n\n## Skill Structure\n\nEach skill contains:\n- `SKILL.md` - Instructions for the agent\n- `rules/` - Individual guideline files\n- `metadata.json` - Version and references\n",
  "bytes": 1794,
  "sha": "1f674cad6293ce3f6c926d38342ffead73a80327890de77f27ea06135ca158d1",
  "repo_slug": "boristane/agent-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_boristane_agent_skills_logging_best_prac_38ad2f38/readme"
}