Skip to content
Skills Library
Programming · Tool integration

bug-reports

/bug-reports

The embedded Clips bug-report flow — the `/bug-report` iframe launcher, `/record?intent=bug-report` capture, `save-bug-report-context`, and its intake limits. Use when embedding bug capture in another product, wiring the launcher, or asked to collect customer bug recordings.

Licence
MIT
Last repository change
27.10.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

The embedded Clips bug-report flow — the `/bug-report` iframe launcher, `/record?intent=bug-report` capture, `save-bug-report-context`, and its intake limits. Use when embedding bug capture in another product, wiring the launcher, or asked to collect customer bug recordings.

Original author description

The embedded Clips bug-report flow — the `/bug-report` iframe launcher, `/record?intent=bug-report` capture, `save-bug-report-context`, and its intake limits. Use when embedding bug capture in another product, wiring the launcher, or asked to collect customer bug recordings.

How it works

  1. Rule
  2. How it works
  3. Hosted anonymous intake
  4. Related skills
Original SKILL.md headings · 37 lines, 198 words
SKILL.md preview
---
name: bug-reports
description: >-
  The embedded Clips bug-report flow — the `/bug-report` iframe launcher,
  `/record?intent=bug-report` capture, `save-bug-report-context`, and its
  intake limits. Use when embedding bug capture in another product, wiring the
  launcher, or asked to collect customer bug recordings.
---

# Embedded Bug Reports

## Rule

`/bug-report` is an iframe-friendly launcher only. The actual capture runs
top-level at `/record?intent=bug-report`, because browser media capture needs a
top-level user gesture.

## How it works

1. The host page embeds `/bug-report` in an iframe.
2. The launcher stores redacted host metadata through `save-bug-report-context`.
3. Capture opens top-level at `/record?intent=bug-report`.
4. The recording remains the canonical resource and defaults to workspace
   (organization) visibility.

## Hosted anonymous intake

For an unauthenticated reporter, the host backend must first call
`create-recording-intake-link` with an organization service token. Pass only the
returned short-lived URL to the iframe. The signed intake capability permits one
private recording and its upload transport, but it cannot read the Clips
library or mint agent access.

The service token is organization-scoped. The normal recording pipeline resolves
that organization's configured Builder.io Connect or S3-compatible storage, so
storage credentials never enter the iframe. Keep the service token on the host
backend and validate both `event.origin` and `event.source` on completion.

## Related skills

- `recording` — the capture and upload path behind `/record`.
- `video-sharing` — why bug-report recordings default to organization
  visibility instead of public.
- `security` — redaction rules for host metadata and diagnostics.

Versions

The database has no other skills named bug-reports.

Database snapshot: 13.11.2026 · package version 2255594c5bf8 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90filing-bug-reports
    Generate a standalone bug report that another developer can use to reproduce, investigate, and fix an issue. Use when the user says 'file a bug', 'write a bug report', 'report this issue', or asks to document a defect for handoff.
  • 100filing-bug-reports
    Generate a standalone bug report that another developer can use to reproduce, investigate, and fix an issue. Use when the user says 'file a bug', 'write a bug report', 'report this issue', or asks to document a defect for handoff.
  • 100qe-bug-reporting-excellence
    Write high-quality bug reports that get fixed quickly. Use when reporting bugs, training teams on bug reporting, or establishing bug report standards.
  • 92bug-reproduction-validator
    Systematically reproduces and validates bug reports to confirm whether reported behavior is an actual bug. Use when you receive a bug report or issue that needs verification.
  • 100bug-reporting-excellence
    Write high-quality bug reports that get fixed quickly. Use when reporting bugs, training teams on bug reporting, or establishing bug report standards.
  • 100create-bug-report
    Create a structured bug report when the user reports a bug, wants to file an issue, document a defect, or needs help writing a bug report with proper reproduction steps

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.