skynet-score
# Skynet Score
Use `{skillDir}/scripts/skynet_score.py` to inspect project score search results with the CertiK public project API.
Use this skill when the user wants to look up a blockchain project's CertiK Skynet score or needs help integrating the public project score API.
## When to use this skill
- Search projects by keyword or approximate project name
- Return a project's overall score, tier, and last update time
- Explain the score breakdown fields
- Show how to query the public endpoint from code or `curl`
## Workflow
1. Extract the project keyword from the user request.
2. Prefer the bundled Python script for execution.
3. If Python is unavailable, use the documented `curl` fallback.
4. If multiple projects match, list the best candidates instead of guessing.
5. When a clear match exists, summarize:
- project name
- overall Skynet score
- tier
- last updated time
- score breakdown fields that matter to the user's question
6. If the user asks for implementation details, provide a minimal request example and note rate limits.
## Execution
Prefer Python first:
```bash
python3 scripts/skynet_score.py --keyword "uniswap"
```
If Python is unavailable, use `curl`:
```bash
curl -sG "https://open.api.certik.com/projects" \
-H "Accept: application/json, text/plain, */*" \
--data-urlencode "keyword=uniswap"
```
## Output guidance
- Do not invent a score when no project match is returned.
- If there are several close matches, ask the user to confirm which project they mean.
- When explaining the result, keep the overall score first and the component scores second.
- If the user asks for raw payloads or integration help, include the response shape below.
## Public API
- Base URL: `https://open.api.certik.com`
- Endpoint: `GET /projects`
- Query parameter: `keyword` (required)
Example:
```bash
curl -sG "https://open.api.certik.com/projects" \
-H "Accept: application/json, text/plain, */*" \
--data-urlencode "keyword=uniswap"
```
Important score fields:
- `score`: overall Skynet score
- `scoreCodeSecurity`: code security score
- `scoreCommunity`: community score
- `scoreFundamental`: fundamentals score
- `scoreGovernance`: governance score
- `scoreMarket`: market score
- `scoreOperation`: operations score
- `tier`: score tier
- `updatedAt`: last update time
## Limits and errors
- Rate limit: 50 requests per 60-second window per IP
- Headers:
- `X-RateLimit-Limit`
- `X-RateLimit-Remaining`
- `X-RateLimit-Reset`
- `Retry-After` on `429`
Error payload:
```json
{
"error": "Human-readable error message"
}
```
Common status codes:
- `400`: missing or invalid parameters
- `429`: rate limit exceeded
- `500`: server-side failure
标签
skill
ai
