Skip to content
Back to search

styleport

Portable design systems for AI coding agents. Extract UI styles from any frontend and adapt them to another without breaking functionality.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/madurolabs--styleport/badge.svg)](/listings/madurolabs--styleport)

HTML

<a href="/listings/madurolabs--styleport"><img src="/api/listings/madurolabs--styleport/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The repository is laid out as a collection of standard `SKILL.md` directories. Install it with the skills CLI from a disposable environment first:

npx skills add MaduroLabs/styleport

For manual installation, copy either skill directory into the agent's project skill directory:

Codex:       .agents/skills/<skill-name>/
Claude Code: .claude/skills/<skill-name>/
Cursor:      .cursor/skills/<skill-name>/

Cursor also discovers the shared `.agents/skills/` layout. See [docs/installation.md](docs/installation.md) for provider-specific notes and invocation examples.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 61 lines
  1. # StylePort
  2. [![skills.sh](https://skills.sh/b/MaduroLabs/styleport)](https://skills.sh/MaduroLabs/styleport)
  3. Portable design systems for AI coding agents. StylePort packages two reusable Agent Skills:
  4. - `frontend-style-extractor` documents an existing frontend as a framework-neutral Portable Design System Bundle.
  5. - `frontend-style-adapter` applies a bundle to another frontend while preserving routes, data, behavior, and accessibility.
  6. The skills are agent-guided workflows. They provide a bundle contract, evidence discipline, a heuristic inventory helper, and a validator; they do not perform uncontrolled AST rewrites or copy application business logic.
  7. ## Repository layout
  8. ```text
  9. skills/
  10. ├── frontend-style-extractor/
  11. └── frontend-style-adapter/
  12. tests/
  13. ├── fixtures/
  14. └── test_packaging.py
  15. docs/
  16. └── installation.md
  17. ```
  18. ## Install
  19. The repository is laid out as a collection of standard `SKILL.md` directories. Install it with the skills CLI from a disposable environment first:
  20. ```bash
  21. npx skills add MaduroLabs/styleport
  22. ```
  23. For manual installation, copy either skill directory into the agent's project skill directory:
  24. ```text
  25. Codex: .agents/skills/<skill-name>/
  26. Claude Code: .claude/skills/<skill-name>/
  27. Cursor: .cursor/skills/<skill-name>/
  28. ```
  29. Cursor also discovers the shared `.agents/skills/` layout. See [docs/installation.md](docs/installation.md) for provider-specific notes and invocation examples.
  30. ## Portable Design System Bundle
  31. The interchange format is versioned as Portable Design System Bundle v1.0.0. A valid bundle contains `manifest.json`, `tokens.json`, `rules.json`, `README.md`, and five rule Markdown files. The extractor and adapter ship identical copies of the contract and validator so either skill can be installed independently.
  32. See [the extractor contract](skills/frontend-style-extractor/references/CONTRACT.md) and [the bundle format guide](docs/bundle-format.md).
  33. ## Development
  34. The test suite uses only the Python standard library:
  35. ```bash
  36. python3 -m unittest discover -s tests -p 'test_*.py'
  37. ```
  38. The CI workflow also validates both skills' metadata, the synthetic inventory fixture, the example bundle, and equality of the shared contract and validator copies.
  39. ## License
  40. StylePort is released under the MIT License. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.