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/asset-transformation.md
View on GitHub# Asset Transformation
Use this reference to create the canonical SVG or faithfully transform an existing mark.
## Authoring rules
- Preserve originals and write derived files with deterministic names.
- Prefer the repository's established asset directory, or `docs/assets/` when none exists.
- Infer only low-risk identity facts from public repository context. State assumptions.
- Author a compact, self-contained SVG directly. Use `drawio-diagrams` only when editable geometric construction materially helps.
- Do not embed raster data, scripts, `foreignObject`, external references, remote fonts, foreign namespaces, comments, editor metadata, or private metadata.
- Keep the canonical SVG at its static first-frame state. Put motion in the separate deterministic specification and in derived web/demo or raster artifacts; the strict validator rejects SMIL, `<style>` blocks, and CSS animation in the canonical master.
- Use allowlisted static SVG elements and attributes, explicit presentation values without CSS variables, and literal same-document `#id` references. Every paint, clip, filter, mask, marker, gradient, pattern, text-path, navigation, and `<use>` fragment must resolve to an appropriate in-document target; empty paint servers are not renderable content.
- Flatten clipping, masks, or filters into directly verifiable geometry before claiming readiness. Effect-bearing geometry is not accepted as the sole proof that a mark visibly renders.
- Use positive concrete `width` and `height`, a positive `viewBox`, meaningful groups or layer identifiers, transparent background by default, and geometry that remains legible at README sizes.
- Do not add a full-canvas background unless the user explicitly requests one.
## Source-specific routes
### No source or intentional redesign
Follow `provider-routing.md`, then turn the accepted concept into a local SVG. Provider output does not replace SVG validation.
### Raster, screenshot, or poster
Treat the input as a reference, not a canonical master. Identify the mark, preserve the original, and recreate it locally on transparency. Avoid simple background removal when glow, noise, or antialiasing would leave matte edges. This faithful route is not Recraft-eligible because it needs reference-media fidelity.
### Existing SVG
Keep a clean SVG as the source route. Simplify excessive paths, name animation layers, remove accidental backgrounds, and remove unsafe or external content without changing the identity. Do not route a clean or faithfully cleaned SVG through Recraft.
## Strict validation
Run:
```bash
python3 scripts/validate_logo_svg.py path/to/logo.svg
```
Treat a non-zero exit as blocking. `Motion readiness: ready` requires this real strict-validator pass in addition to a complete motion specification and checked animation recipe. If Python is unavailable, report `Motion readiness: blocked`; do not substitute visual confidence for validation.
Also inspect the rendered mark on light, dark, and checkerboard backgrounds. Visual inspection supplements, but never replaces, structural validation.
## Mutation boundaries
Ask before overwriting a brand file, installing a tool, spending provider credits, publishing, or changing remote state. Creating the five absent derived files is allowed only when the user requested `create`, `transform`, or `animate`; `audit` is read-only.
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: 196k | Updated | Claude CodeCodex | Verified | Install |