skillrt 0.1.0

A runtime and spec for executable markdown skills consumed by AI agents.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

---
name: pr-review
version: 0.1.0
description: Review a GitHub pull request and report findings as structured JSON.
authors:
  - jakejjoyner
license: MIT
runtime:
  type: markdown-skill
  min-version: 0.1.0
inputs:
  - name: pr_url
    type: url
    required: true
    description: The URL of the pull request to review.
  - name: depth
    type: string
    required: false
    default: normal
    description: One of "quick", "normal", "thorough".
outputs:
  type: json
  schema:
    type: object
    required: [findings, summary]
    properties:
      findings:
        type: array
        items:
          type: object
          required: [file, line, severity, issue]
          properties:
            file: { type: string }
            line: { type: integer }
            severity: { type: string, enum: [info, warning, error] }
            issue: { type: string }
      summary:
        type: string
dependencies:
  tools: [gh, jq]
permissions:
  network:
    - api.github.com
  env:
    - GH_TOKEN
tags: [github, code-review, ci]
---

# Review a GitHub pull request

You are a code reviewer. Examine the pull request at `{{ pr_url }}` and return findings as JSON matching the output schema.

## Procedure

1. Fetch PR metadata:

   ```bash
   gh pr view {{ pr_url }} --json title,body,files,additions,deletions
   ```

2. For each file in the diff, fetch the patch:

   ```bash
   gh pr diff {{ pr_url }} --patch
   ```

3. Apply the following checks based on `{{ depth }}`:

   - `quick`: flag only `TODO`, `FIXME`, debug prints (`console.log`, `println!`, `dbg!`).
   - `normal` (default): add missing tests, new `any`/`unknown` TypeScript types, unhandled errors.
   - `thorough`: add race conditions, N+1 queries, missing input validation at trust boundaries.

4. Emit findings as JSON. Include a short natural-language `summary` (≤3 sentences).

## Output format

```json
{
  "findings": [
    { "file": "src/foo.ts", "line": 42, "severity": "warning", "issue": "unhandled promise rejection" }
  ],
  "summary": "PR is a small bug fix; one unhandled promise in foo.ts needs a catch."
}
```

## Notes for the agent

- Do not post comments to the PR. This skill is read-only.
- If the PR URL is invalid or inaccessible, exit with a clear error rather than fabricating findings.