stark-ai-de/agent-skills / plugins/stark-ai-developer/skills/animated-readme-logo
animated-readme-logo
VerifiedCreate, transform, animate, or audit GitHub README logos and their verified SVG/PNG/GIF delivery. Use when a repository needs branding assets, not ordinary README prose or app/site motion.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.7 KB |
| agents/openai.yaml | config | 591 B |
| assets/openai-icon.png | binary | 63.2 KB |
| references/asset-pipeline.md | markdown | 2.8 KB |
| references/asset-transformation.md | markdown | 3.3 KB |
| references/export-recipe.md | markdown | 6.9 KB |
| references/github-readme-compatibility.md | markdown | 3.1 KB |
| references/local-tooling.md | markdown | 3.8 KB |
| references/motion-rubric.md | markdown | 1.9 KB |
| references/output-contract.md | markdown | 3.1 KB |
| references/provider-routing.md | markdown | 3.0 KB |
| references/readme-audit-safety.md | markdown | 3.1 KB |
| references/readme-snippets.md | markdown | 2.3 KB |
| scripts/audit-readme-logo-assets.mjs | script | 44.9 KB |
| scripts/export-readme-logo-animation.mjs | script | 54.6 KB |
| scripts/generate-readme-logo-snippet.mjs | script | 5.9 KB |
| scripts/inspect-animated-image.mjs | script | 4.6 KB |
| scripts/lib/animated-image.mjs | script | 29.1 KB |
| scripts/lib/transactional-output.mjs | script | 16.3 KB |
| scripts/validate_logo_svg.py | script | 79.8 KB |
references/local-tooling.md
View on GitHub# Local Tooling and Browser Fallbacks
Use this reference when a requested raster export, inspection, or visual preview lacks a working command.
## Keep capabilities separate
- SVG rasterizer: prefer `rsvg-convert` from librsvg for deterministic SVG-to-PNG frames.
- Animation encoder and probe: prefer headless FFmpeg with `ffmpeg` and `ffprobe` for GIF, APNG, and animated WebP.
- Structural inspection: use the bundled strict SVG validator and animated-image inspector; do not replace them with exporter self-reporting.
- Reusable GIF path: use the bundled `export-readme-logo-animation.mjs` after reviewing and checking the repository-owned recipe; the script performs no installation and preserves existing outputs on failure.
- Browser preview: use a configured Chrome or Chromium executable. It is not an exporter or inspector.
Do not report the whole pipeline unavailable because only a screenshot browser is missing.
## Missing-tool approval checkpoint
When a requested output needs a missing command:
1. Identify the exact missing command, requested output, active package manager, and whether the repository has a declarative source of truth.
2. Select the smallest package set. Prefer librsvg plus headless FFmpeg. Use ImageMagick or Inkscape only when a source requires a feature the smaller set lacks.
3. Present the package names, source, exact install command, persistence scope, expected download or disk impact when discoverable, and post-install verification commands.
4. Ask for explicit approval of that exact installation. Keep provider approval separate.
5. Stop before installation with `Animation delivery: blocked` and a clearly labeled local-tool approval pending.
6. After approval, install only the displayed set. Verify executable versions and the requested encoder, muxer, and filter support before exporting.
7. If the user declines, forbids installation, or the install path is unavailable, use `Animation delivery: incomplete`, retain verified intermediates, and create no placeholder.
Never turn an approval for one package manager, version, or package set into a broader update or installation.
## Platform selection
- Nix or NixOS: prefer `librsvg` and `ffmpeg-headless`. Add them to the repository's declarative package source when requested. If activating a dirty configuration would apply unrelated changes, propose a pinned temporary shell or profile install separately; do not switch the whole system implicitly.
- Debian or Ubuntu: discover the active release packages before proposing them; common names are `librsvg2-bin` and `ffmpeg`.
- Homebrew: common formulae are `librsvg` and `ffmpeg`.
Package names and versions are live facts. Inspect the active package manager instead of treating these examples as guarantees.
## Browser-preview fallback ladder
1. Inspect the current browser tool's help and environment for an explicit executable path or managed browser directory.
2. Retry with an existing compatible Chrome or Chromium executable. Do not require Chrome for Testing when a managed browser works.
3. If `agent-browser` already exists, inspect its version and help. When supported, load `agent-browser skills get core`, then launch with the existing executable path and capture the preview.
4. If the CLI is missing or too old, present an approval checkpoint for an exact `agent-browser` install or upgrade. Reuse an existing browser after installation.
5. Only when no compatible local browser exists, offer an approval-gated browser download such as `agent-browser install` or the platform's managed Chromium package.
6. If every approved route fails, report the local screenshot limitation and retain the manual committed-GitHub preview requirement.
Browser installation, browser launch, and provider generation are three different side-effect classes. Never infer approval across them.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |