# Skillsights

> Analytics and trust platform for AI skill publishers.

Skillsights helps AI skill and tool publishers understand how agents use their skills. It provides invocation tracking, agent feedback collection, trust scoring, and regression alerts.

## What Skillsights Does

- **Invocation Analytics**: Track every skill invocation with success rates, latency percentiles, and error patterns in real time.
- **Agent Feedback**: Collect structured feedback from AI agents including satisfaction scores, failure reasons, and feature requests.
- **Trust Scores**: Earn trust through verified performance data. Scores reflect real usage, not self-reported metrics.
- **Regression Alerts**: Get notified when success rates or satisfaction drops via email or webhook.
- **Publisher Verification**: Verify identity via domain DNS or GitHub OAuth for higher trust tiers.
- **SDK Integration**: Drop-in Node.js SDK with zero runtime dependencies and fire-and-forget telemetry.

## API

Base URL: `https://app.skillsights.dev`

### Public Reputation API

- `GET /v1/reputation/skills/{skill_id}` — Get trust score, tier, signals, and badges for a skill
- `GET /v1/reputation/publishers/{publisher_id}` — Get aggregate reputation for a publisher
- `GET /v1/reputation/search?q={query}` — Search skills by name or ID

### Collector API (requires API key)

- `POST /v1/receipts/invocation` — Submit an invocation receipt
- `POST /v1/receipts/feedback` — Submit feedback for an invocation

## SDK

Install: `npm install @skillsights/sdk`

```typescript
import { Skillsights } from '@skillsights/sdk';

const skillsights = new Skillsights({
  apiKey: process.env.SKILLSIGHTS_API_KEY,
  skillId: 'your-domain.com/your-skill',
});

const handler = skillsights.wrap(async (input) => {
  // Your skill logic here
  return result;
});
```

## MCP Reputation Tool

Install: `npm install @skillsights/reputation-mcp`

Tool: `check_skill_reputation(skill_id)` — Returns trust tier, score, signals, and badges.

## Pricing

- **Free**: 1,000 invocations/month, basic analytics, email alerts
- **Starter** ($29/mo): 10,000 invocations/month, full analytics, trust score insights
- **Pro** ($99/mo): 100,000 invocations/month, custom integrations, advanced trust tiers

## Links

- Documentation: https://app.skillsights.dev/docs
- Pricing: https://app.skillsights.dev/pricing
- Sign up: https://app.skillsights.dev/register
- SDK on npm: https://www.npmjs.com/package/@skillsights/sdk