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/readme-audit-safety.md
View on GitHub# README Audit Safety
Use this reference when inspecting local image references in README markup.
## Boundary
Declare a repository root and pass the README as a root-relative path:
```bash
node scripts/audit-readme-logo-assets.mjs --root . --readme README.md
```
Treat the README path and every local `src`, `srcset`, or Markdown image target as untrusted input.
Accept a local reference only when all of these are true:
- it is a relative filesystem path;
- normalization does not traverse above the declared root;
- it is not POSIX absolute, Windows drive-absolute, or UNC/network syntax;
- query and fragment suffixes are removed only for filesystem resolution, not to reinterpret a remote URL as local;
- the resolved file and every followed symlink stay inside the canonical root;
- the target is a regular file when an asset read is attempted.
Reject and report the reference without opening it when any check fails. Do not silently rewrite an unsafe reference into an allowed path.
Root-bounded `..` segments from a nested README are valid only when component-wise and canonical resolution remains inside the declared root. Preserve component order while walking: never collapse `symlink/..` lexically before checking the symlink target. Inline, angle-bracket, balanced-parenthesis, full/collapsed/shortcut reference images, HTML `src`, and candidate-wise `srcset` values receive the same boundary checks. Code examples and HTML comments are not live image references.
For the supported README contract, each `<source>` uses exactly one bare URL in `srcset`; `src` on `<source>` is inert and rejected. Descriptors and multi-candidate `srcset` values are outside this deterministic contract. A `<picture>` contains exactly one final `<img>`, every `<source>` precedes it, and the fallback has a non-empty `src` or single-bare-URL `srcset`, alt text, and positive-integer `width` and `height`. Nested or unclosed `<picture>` markup fails closed. Candidates or ancestors hidden with the HTML `hidden` attribute or obvious inline visibility/opacity styles cannot satisfy readiness.
## Read-only behavior
The audit may read the declared README and root-bounded referenced assets. README and inspected SVG content are capped at 5 MiB, image/reference counts are bounded, and raster animation checks use the bundled structural inspector. It must not create, rewrite, delete, rename, chmod, or stage files. It may report remote HTTP(S) and data URLs as remote or embedded without fetching them.
## Report
For each local or rejected reference, report its source location, normalized root-relative path when safe, and any compatibility risk. Verify the SVG with the bundled strict validator and distinguish static from animated GIF/PNG/APNG/WebP content. A reduced-motion source must be verified static, precede animated candidates, and retain a verified-static final `<img>` fallback.
Summarize rejected absolute, UNC, root-escaping traversal, missing, or symlink-escaping references separately. Never print the canonical root or raw filesystem errors. Exit `0` means clean, `1` means compatibility/readiness findings, and `2` means unsafe input or a path-boundary rejection.
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 |