native-effect-authoring SKILL.md skillA

native-effect-authoring from hyperb1iss/hypercolor is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add hyperb1iss/hypercolor/native-effect-authoring@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
hyperb1iss/hypercolor
Path
.agents/skills/native-effect-authoring/SKILL.md
Versions recorded
5
Latest version
v1.0.0, committed Aug 26, 2026
First version recorded
Apr 10, 2026
Size
15,866 bytes
Repository stars
31
License
Apache-2.0

This skill should be used when writing Rust-native effects for Hypercolor's native rendering path. Triggers on "native effect", "builtin effect", "Rust effect", "EffectRenderer", "FrameInput", "tick function", "audio reactive Rust", "canvas fill", "effect renderer trait", "write a new effect", "builtin audio pulse", "breathing effect", "color wave", or any work in crates/hypercolor-core/src/effect/builtin/.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Native Effect Authoring

Native effects are Rust implementations of `EffectRenderer` in
`crates/hypercolor-core/src/effect/builtin/`. They render directly to Canvas
without Servo, the fastest path at about 1ms per frame.

## EffectRenderer Trait Contract

Every fallible method returns `anyhow::Result<()>`; there is no dedicated
control error type. Five methods sit outside that shape, all visible in the
signatures below: `destroy`, `bind_asset_library`, and `set_display_descriptor`
return `()`, `preview_canvas` returns `Option<Canvas>`, and `render_output`
returns `anyhow::Result<EffectRenderOutput>`. Four methods are required, seven
have default bodies.

```rust
pub trait EffectRenderer: Send {
    // Required.
    fn init(&mut self, metadata: &EffectMetadata) -> anyhow::Result<()>;
    fn render_into(&mut self, input: &FrameInput<'_>, target: &mut Canvas)
        -> anyhow::Result<()>;
    fn apply_controls(&mut self, batch: &ControlDeltaBatch<'_>) -> anyhow::Result<()>;
    fn destroy(&mut self);

    // Defaulted: override only when you need them.
    fn init_with_canvas_size(
        &mut self,
        metadata: &EffectMetadata,
        canvas_width: u32,
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add hyperb1iss/hypercolor/native-effect-authoring@sha256:9beedb084d63a3a7

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_pgq5r5tilkfqis47.svg)](https://markdownregistry.com/a/art_pgq5r5tilkfqis47)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Apr 10, 2026 and Aug 26, 2026, about one every 34 days.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-08-26 05acaca 15,866 BA view · diff
v1.0.02026-08-23 31e0d5d 8,461 BA view · diff
v1.0.02026-08-16 473ba60 7,960 BA view · diff
v1.0.02026-04-26 4fd7a93 7,960 BA view · diff
v1.0.02026-04-10 a0ecd22 6,866 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (15866 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

hyperb1iss/hypercolor · 31 stars · license Apache-2.0 · pushed 2026-10-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_pgq5r5tilkfqis47
GET https://markdownregistry.com/api/v1/resolve?ref=hyperb1iss/hypercolor/native-effect-authoring
GET https://markdownregistry.com/api/v1/blob/9beedb084d63a3a783dd20779cf0fc66896b4dc7b2435dfb7f0bf52c9c394288

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from hyperb1iss/hypercolor

daemon-development SKILL.md skill
hyperb1iss/hypercolor · .agents/skills/daemon-development/SKILL.md · This skill should be used when working on the Hypercolor daemon, REST API, WebSocket protocol, or render pipeline…
git:20260902.2acf607 · audit B · 31 stars
hal-driver-development SKILL.md skill
hyperb1iss/hypercolor · .agents/skills/hal-driver-development/SKILL.md · This skill should be used when writing, porting, or debugging device drivers in hypercolor-hal. Triggers on "add a…
v1.0.0 · audit B · 31 stars
leptos-ui-development SKILL.md skill
hyperb1iss/hypercolor · .agents/skills/leptos-ui-development/SKILL.md · This skill should be used when working on the Hypercolor web UI in crates/hypercolor-ui/. Triggers on "UI component"…
v1.0.0 · audit A · 31 stars
protocol-research SKILL.md skill
hyperb1iss/hypercolor · .agents/skills/protocol-research/SKILL.md · This skill should be used when researching device protocols before implementing drivers. Triggers on "reverse engineer…
v1.0.0 · audit A · 31 stars
rgb-effect-design SKILL.md skill
hyperb1iss/hypercolor · .agents/skills/rgb-effect-design/SKILL.md · This skill should be used when creating, modifying, or debugging RGB lighting effects for Hypercolor or…
v1.0.0 · audit A · 31 stars
AGENTS.md AGENTS.md file
hyperb1iss/hypercolor · AGENTS.md
git:20261019.59d5ef8 · audit A · 31 stars
CLAUDE.md CLAUDE.md file
hyperb1iss/hypercolor · CLAUDE.md
git:20260306.dee2ab7 · audit B · 31 stars
effect-livecoding SKILL.md skill
hyperb1iss/hypercolor · skills/effect-livecoding/SKILL.md · Write, debug, and tune a Hypercolor lighting effect against a running daemon in a tight loop: install an HTML page…
git:20261017.5f253be · audit B · 31 stars
hypercolor-control SKILL.md skill
hyperb1iss/hypercolor · skills/hypercolor-control/SKILL.md · Use this skill when an agent needs to inspect or control a running Hypercolor daemon, browse or activate effects, patch…
git:20261017.0c90a05 · audit B · 31 stars
rig-setup SKILL.md skill
hyperb1iss/hypercolor · skills/rig-setup/SKILL.md · Set up a Hypercolor spatial layout and scene for a PC build from scratch: research the case's real dimensions…
git:20260907.18d3bf6 · audit A · 31 stars

Every file in hyperb1iss/hypercolor

Browse by kind, by grade A, or by owner.