{"slug":"jakubkrehel-better-ui","name":"better-ui","description":"Polishes and improves the UI in your project. Covers concentric border radius, optical alignment, surface depth, contextual icons, hit areas and more.","long_description":"---\nname: better-ui\ndescription: Polishes and improves the UI in your project. Covers concentric border radius, optical alignment, surface depth, contextual icons, hit areas and more.\n---\n\n# UI polish\n\nPolish comes from a pile of small details that compound. This skill is the reference for which are worth having and what values they take.\n\nWhen reviewing, slow the interface down. What feels off at 10% speed is what is subtly wrong at full speed.\n\nKeep the project's component library, tokens and density, and match its motion language except where a rule below prescribes an exact interaction.\n\nEvery duration, curve, scale and blur below is a specific value, not a range to approximate. `cubic-bezier(0.2, 0, 0, 1)` is not `cubic-bezier(0.4, 0, 0.2, 1)`, and `0.96` is not `0.95`. Use what is written.\n\nText wrapping, font rendering, tabular numbers and text spacing belong to `better-typography`. Hit areas, focus, keyboard support, ARIA and reduced motion belong to `better-accessibility`. Grouping, section spacing, breakpoints and spatial RTL belong to `better-layout`.\n\n## Concentric border radius\n\nOuter radius = inner radius + padding. Mismatched radii on nested elements is the most common thing that makes an interface feel off. Radius, shadow and outline recipes are in [surfaces.md](surfaces.md).\n\n## Optical over geometric alignment\n\nWhen geometric centering looks off, align optically. Buttons with icons, play triangles and asymmetric icons all need a manual nudge.\n\n## Shadows for elevation, borders for structure\n\nWhere a border exists only to create depth, prefer layered transparent `box-shadow` values. Keep borders that communicate structure or state: dividers, separators and selected or focus states.\n\n## Interruptible animations\n\nUse CSS transitions for interactive state changes, because they can be interrupted mid-animation. Reserve keyframes for staged sequences that run once.\n\n## Split and stagger enter animations\n\nFor an infrequent staged entrance where sequence communicates hierarchy, break the content into semantic chunks and stagger them by ~100ms. Animating one container gets you less for the same cost. Leave high-frequency interactions unstaggered. See [enter-exit.md](enter-exit.md).\n\n## Subtle exit animations\n\nUse a small fixed `translateY` rather than full height. Exits should be softer than enters. Use `ease-out` for both directions.\n\n## Contextual icon animations\n\nAnimate icons with `opacity`, `scale` and `blur` rather than toggling visibility. Use exactly these values: scale `0.25` to `1`, opacity `0` to `1`, blur `4px` to `0px`.\n\nWith a motion library (`motion` or `framer-motion` in `package.json`), match that package's import path, or nearby imports where both exist. Use `transition: { type: \"spring\", duration: 0.3, bounce: 0 }`. Bounce is always `0`.\n\nWithout one, keep both icons in the DOM with one absolutely positioned, and cross-fade with `cubic-bezier(0.2, 0, 0, 1)`. That gives you enter and exit with no dependency. Both recipes are in [icon-transitions.md](icon-transitions.md).\n\n## Image outlines\n\nGive images a `1px` outline at low opacity for consistent depth. Pure black in light mode (`oklch(0 0 0 / 0.1)`), pure white in dark (`oklch(1 0 0 / 0.1)`). Never a near-black like slate or zinc and never a tinted neutral. A tinted outline picks up the surface underneath and reads as dirt on the image edge.\n\n## Scale on press\n\nA `scale(0.96)` on click gives a button tactile feedback. Always `0.96`; anything below `0.95` feels exaggerated. Add a `static` prop to switch it off where motion would distract. See [recipes for CSS, Tailwind and Motion](animations.md#scale-on-press).\n\n## Skip animation on page load\n\nUse `initial={false}` on `AnimatePresence` to keep enter animations off the first render. Check that it leaves intentional page entrances intact.\n\n## Suppress transitions on theme switch\n\nA theme flip changes color, background, border and shadow on nearly every element at once. Every transition on those properties fires together and the switch smears instead of snapping. Inject `*,*::before,*::after{transition:none !important}`, force a reflow, then remove it on the next frame. See the [recipe](animations.md#suppress-transitions-on-theme-switch).\n\n## Transition only what changes\n\nAlways name the exact properties: `transition-property: scale, opacity`. Tailwind's `transition-transform` covers `transform, translate, scale, rotate`.\n\n## Use `will-change` sparingly\n\nOnly for `transform`, `opacity` and `filter`, which the GPU can composite. Never `will-change: all`. Add it when you see first-frame stutter, not before. See [performance.md](performance.md).\n\n## Match icon stroke to text weight\n\nAn icon next to text carries the text's optical weight: `1.5px` stroke beside regular (400) text, `2px` beside semibold (600). One stroke weight per icon set and one icon library per surface. Sizing and RTL flipping are in [icons.md](icons.md).\n\n## One SVG, recolored per state\n\nIcons use `currentColor` and take hover, selected and disabled states from CSS color and opacity, never from separate assets. Outline is the default variant; fill marks the active state.\n\n## Motion restraint\n\nGive high-frequency interactions instant feedback, or a transition of `150ms` or less on opacity and color. A custom animation there charges its attention cost on every trigger.\n\nEvery animated state change also needs a static cue: color, an icon, or a label. Motion is never the only feedback channel.\n\n## Before you finish\n\n| Mistake | Fix |\n| --- | --- |\n| Icons look off-center | Nudge optically with padding, or fix the SVG |\n| Jarring staged entrance or exit | Stagger infrequent entrances; keep exits subtle |\n| Theme toggle crossfades the whole page | Disable transitions for the swap, force a reflow, restore on the next frame |\n| `transition: all` on elements | Specify exact properties |\n| First-frame animation stutter | Add `will-change: transform` (sparingly) |\n| Hairline icon beside bold text | Match the stroke width to the text weight |\n\n## Reporting\n\n**Severity.** `HIGH` breaks an interaction, makes motion unusable, or leaves a state change visible only while the animation runs. `MEDIUM` is a visible inconsistency in surfaces, icons, or motion. `LOW` is isolated polish.\n\n**Verification.** Without a browser: every state the component defines, meaning hover, focus, active, loading and empty, plus motion durations and easings read from the code. With one: walk each state, and replay motion at 10% speed in the browser's Animations panel. Report every check you could not run as `Not verified`.\n\n**Format.** Group findings under the principle each violates, ordered by severity, one row per root cause listing every location it appears in:\n\n| Severity | Location | Before | After | Why |\n| --- | --- | --- | --- | --- |\n\n`Location` is `path/to/file:line`. `Why` names the principle and the user impact.\n\nEnd with `Block` when any `HIGH` remains, `Approve` otherwise, leaving the rest in the table as work to do. Never `Approve` coverage you did not inspect. With nothing to report, state \"No actionable UI-polish findings\" and report verification.\n","tagline":"Polishes and improves the UI in your project. Covers concentric border radius, optical alignment, surface depth, contextual icons, hit areas and more.","category":"design-creative","tags":["agent-skill"],"author":"jakubkrehel","verified":false,"attribution":{"status":"registry_indexed","statusLabel":"Registry indexed","shortLabel":"REGISTRY INDEXED","sourceLabel":"github candidate review","sourceDetail":"jakubkrehel/skills","creatorName":"jakubkrehel","creatorUrl":"https://github.com/jakubkrehel","sourceUrl":"https://github.com/jakubkrehel/skills/tree/main/skills/better-ui","indexedBy":"OpenAgentSkill community index","claimUrl":"https://www.openagentskill.com/skills/jakubkrehel-better-ui#claim-this-skill","claimCta":"Claim this skill","trustNote":"This listing was indexed from public sources and is not marked official until a maintainer claim is approved.","publicNote":"Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals."},"stats":{"stars":4744,"forks":160,"verified_installs":0,"successful_runs":0,"total_outcomes":0,"rating":0,"review_count":0,"quality_score":48.98},"quality":{"score":84,"tier":"strong","label":"Strong","summary":"Solid option that is likely worth shortlisting for production workflows.","signals":[{"label":"GitHub stars","value":"4.7K","tone":"positive"},{"label":"Freshness","value":"9d ago","tone":"positive"},{"label":"Install ready","value":"Yes","tone":"positive"},{"label":"License","value":"MIT","tone":"neutral"}],"warnings":["SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions."]},"trust":{"version":"trust-score-v5","score":64,"base_score":72,"outcome_confidence":0,"tier":"review","label":"Sandbox only","summary":"Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.","recommendedAction":"Run only in a sandbox and compare close alternatives before using it for real work.","decision":{"install_policy":"sandbox_only","auto_install_allowed":false,"human_review_required":true,"sandbox_first":true,"agent_action":"Compare alternatives before installing.","reasoning":["64/100 Trust Score v5","72/100 Trust Score v4 baseline","Needs more real agent outcomes before unattended install","Install path is available","Review before production"],"review_required_when":["The workspace contains production secrets, payments, private customer data, or irreversible actions.","The install command requests shell, network, credential, database, or broad filesystem access.","Outcome evidence is missing, recently failed, or required human review.","Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"]},"dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":86,"weight":0.13,"status":"pass","detail":"4.7K GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":77,"weight":0.08,"status":"info","detail":"4.7K stars, 160 forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"9d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"MIT"},{"id":"documentation","label":"README/SKILL.md completeness","score":76,"weight":0.14,"status":"info","detail":"Public metadata needs stronger README/SKILL.md context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":72,"weight":0.12,"status":"info","detail":"external package install surface, network or browser surface"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add jakubkrehel/skills --skill better-ui"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":72,"weight":0.07,"status":"info","detail":"filesystem or document access, network or browser access"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/jakubkrehel/skills/tree/main/skills/better-ui"},{"id":"review_status","label":"Review status","score":66,"weight":0.05,"status":"info","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"pass","label":"GitHub adoption","detail":"4.7K GitHub stars"},{"status":"info","label":"Stars/forks activity","detail":"4.7K stars, 160 forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"9d since push"},{"status":"pass","label":"License clarity","detail":"MIT"},{"status":"info","label":"README/SKILL.md completeness","detail":"Public metadata needs stronger README/SKILL.md context"},{"status":"info","label":"Dependency/runtime risk","detail":"external package install surface, network or browser surface"},{"status":"pass","label":"Install availability","detail":"npx skills add jakubkrehel/skills --skill better-ui"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"info","label":"Permission surface","detail":"filesystem or document access, network or browser access"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/jakubkrehel/skills/tree/main/skills/better-ui"},{"status":"info","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"pass","label":"OpenAgentSkill usage","detail":"1 views, 0 install copies"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["AI review approved","Install path is available","Repository evidence is available","Recently maintained repository","Meaningful GitHub adoption signal","Install command has no obvious high-risk pattern","Outcome loop is ready but needs first real agent run"],"warnings":["SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval.","Quality score needs review","No real agent outcome reports yet","Human review required before unattended installation"],"evidence":{"stars":"4.7K GitHub stars","repoActivity":"4.7K stars, 160 forks","lastPushed":"9d since push","license":"MIT","repository":"https://github.com/jakubkrehel/skills/tree/main/skills/better-ui","install":"npx skills add jakubkrehel/skills --skill better-ui","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, network or browser access","documentation":"Usable metadata, review docs","agentOutcomes":"No agent outcome data yet","agentProvenScore":0,"outcomeConfidence":"0%","installPolicy":"sandbox_only"},"installReadiness":{"ready":true,"command":"npx skills add jakubkrehel/skills --skill better-ui","policy":"sandbox_only","label":"Sandbox only","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","9d since push","Trust Score v5 requires review or sandbox-only use before install."]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval.","Quality score needs review"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"sandbox_only","reason":"Compare alternatives before installing."},"outcome_loop":{"version":"openagentskill-agent-outcome-v4","required_after_install":true,"endpoint":"/api/agent/outcome","method":"POST","event_id_source":"feedback.event_id, install_receipt.resolve_event_id, or decision_packet.outcome_feedback.event_id","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"required_fields":["event_id","skill_slug","task"],"quality_fields":["task_success","output_quality","error_type","human_review_required","used_in_production","workspace","evidence_url","time_to_useful_ms","source_version"],"ranking_inputs_updated":["Trust Score v5 outcome confidence","Agent Proven Score","Resolve ranking task-fit evidence","Skill detail machine-readable metadata","Outcome leaderboard"]},"agent_contract":{"suited_tasks":["design-creative","agent-skill"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"install_command":"npx skills add jakubkrehel/skills --skill better-ui","trust_score":64,"trust_version":"trust-score-v5","risk_level":"medium","do_not_use_when":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace","Live brokerage, exchange, wallet, or payment credentials outside an explicitly approved sandbox"],"before_install":["Read the audit page and machine-readable metadata.","Confirm the install command, license, and permission surface fit the workspace.","Get explicit human approval or choose an alternative before installing."],"after_run":["Report the outcome to /api/agent/outcome using the resolve event id.","Include output_quality, workspace, human_review_required, and evidence_url when available.","Re-resolve before broad production rollout."]},"bestFor":["design-creative","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace","Live brokerage, exchange, wallet, or payment credentials outside an explicitly approved sandbox"],"knownRisks":["SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval.","Quality score needs review"],"backward_compatible":{"trust_score_v4":{"version":"trust-score-v4","score":72,"tier":"strong","label":"Strong shortlist","summary":"Good trust signals with a few areas worth checking before rollout."}}},"trust_score_v5":{"version":"trust-score-v5","score":64,"base_score":72,"outcome_confidence":0,"tier":"review","label":"Sandbox only","summary":"Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.","recommendedAction":"Run only in a sandbox and compare close alternatives before using it for real work.","decision":{"install_policy":"sandbox_only","auto_install_allowed":false,"human_review_required":true,"sandbox_first":true,"agent_action":"Compare alternatives before installing.","reasoning":["64/100 Trust Score v5","72/100 Trust Score v4 baseline","Needs more real agent outcomes before unattended install","Install path is available","Review before production"],"review_required_when":["The workspace contains production secrets, payments, private customer data, or irreversible actions.","The install command requests shell, network, credential, database, or broad filesystem access.","Outcome evidence is missing, recently failed, or required human review.","Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"]},"dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":86,"weight":0.13,"status":"pass","detail":"4.7K GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":77,"weight":0.08,"status":"info","detail":"4.7K stars, 160 forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"9d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"MIT"},{"id":"documentation","label":"README/SKILL.md completeness","score":76,"weight":0.14,"status":"info","detail":"Public metadata needs stronger README/SKILL.md context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":72,"weight":0.12,"status":"info","detail":"external package install surface, network or browser surface"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add jakubkrehel/skills --skill better-ui"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":72,"weight":0.07,"status":"info","detail":"filesystem or document access, network or browser access"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/jakubkrehel/skills/tree/main/skills/better-ui"},{"id":"review_status","label":"Review status","score":66,"weight":0.05,"status":"info","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"pass","label":"GitHub adoption","detail":"4.7K GitHub stars"},{"status":"info","label":"Stars/forks activity","detail":"4.7K stars, 160 forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"9d since push"},{"status":"pass","label":"License clarity","detail":"MIT"},{"status":"info","label":"README/SKILL.md completeness","detail":"Public metadata needs stronger README/SKILL.md context"},{"status":"info","label":"Dependency/runtime risk","detail":"external package install surface, network or browser surface"},{"status":"pass","label":"Install availability","detail":"npx skills add jakubkrehel/skills --skill better-ui"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"info","label":"Permission surface","detail":"filesystem or document access, network or browser access"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/jakubkrehel/skills/tree/main/skills/better-ui"},{"status":"info","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"pass","label":"OpenAgentSkill usage","detail":"1 views, 0 install copies"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["AI review approved","Install path is available","Repository evidence is available","Recently maintained repository","Meaningful GitHub adoption signal","Install command has no obvious high-risk pattern","Outcome loop is ready but needs first real agent run"],"warnings":["SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval.","Quality score needs review","No real agent outcome reports yet","Human review required before unattended installation"],"evidence":{"stars":"4.7K GitHub stars","repoActivity":"4.7K stars, 160 forks","lastPushed":"9d since push","license":"MIT","repository":"https://github.com/jakubkrehel/skills/tree/main/skills/better-ui","install":"npx skills add jakubkrehel/skills --skill better-ui","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, network or browser access","documentation":"Usable metadata, review docs","agentOutcomes":"No agent outcome data yet","agentProvenScore":0,"outcomeConfidence":"0%","installPolicy":"sandbox_only"},"installReadiness":{"ready":true,"command":"npx skills add jakubkrehel/skills --skill better-ui","policy":"sandbox_only","label":"Sandbox only","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","9d since push","Trust Score v5 requires review or sandbox-only use before install."]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval.","Quality score needs review"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"sandbox_only","reason":"Compare alternatives before installing."},"outcome_loop":{"version":"openagentskill-agent-outcome-v4","required_after_install":true,"endpoint":"/api/agent/outcome","method":"POST","event_id_source":"feedback.event_id, install_receipt.resolve_event_id, or decision_packet.outcome_feedback.event_id","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"required_fields":["event_id","skill_slug","task"],"quality_fields":["task_success","output_quality","error_type","human_review_required","used_in_production","workspace","evidence_url","time_to_useful_ms","source_version"],"ranking_inputs_updated":["Trust Score v5 outcome confidence","Agent Proven Score","Resolve ranking task-fit evidence","Skill detail machine-readable metadata","Outcome leaderboard"]},"agent_contract":{"suited_tasks":["design-creative","agent-skill"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"install_command":"npx skills add jakubkrehel/skills --skill better-ui","trust_score":64,"trust_version":"trust-score-v5","risk_level":"medium","do_not_use_when":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace","Live brokerage, exchange, wallet, or payment credentials outside an explicitly approved sandbox"],"before_install":["Read the audit page and machine-readable metadata.","Confirm the install command, license, and permission surface fit the workspace.","Get explicit human approval or choose an alternative before installing."],"after_run":["Report the outcome to /api/agent/outcome using the resolve event id.","Include output_quality, workspace, human_review_required, and evidence_url when available.","Re-resolve before broad production rollout."]},"bestFor":["design-creative","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace","Live brokerage, exchange, wallet, or payment credentials outside an explicitly approved sandbox"],"knownRisks":["SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval.","Quality score needs review"],"backward_compatible":{"trust_score_v4":{"version":"trust-score-v4","score":72,"tier":"strong","label":"Strong shortlist","summary":"Good trust signals with a few areas worth checking before rollout."}}},"trust_score_v4":{"version":"trust-score-v4","score":72,"tier":"strong","label":"Strong shortlist","summary":"Good trust signals with a few areas worth checking before rollout.","recommendedAction":"Test in a sandbox workflow and compare its install path with close alternatives.","dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":86,"weight":0.13,"status":"pass","detail":"4.7K GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":77,"weight":0.08,"status":"info","detail":"4.7K stars, 160 forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"9d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"MIT"},{"id":"documentation","label":"README/SKILL.md completeness","score":76,"weight":0.14,"status":"info","detail":"Public metadata needs stronger README/SKILL.md context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":72,"weight":0.12,"status":"info","detail":"external package install surface, network or browser surface"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add jakubkrehel/skills --skill better-ui"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":72,"weight":0.07,"status":"info","detail":"filesystem or document access, network or browser access"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/jakubkrehel/skills/tree/main/skills/better-ui"},{"id":"review_status","label":"Review status","score":66,"weight":0.05,"status":"info","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"pass","label":"GitHub adoption","detail":"4.7K GitHub stars"},{"status":"info","label":"Stars/forks activity","detail":"4.7K stars, 160 forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"9d since push"},{"status":"pass","label":"License clarity","detail":"MIT"},{"status":"info","label":"README/SKILL.md completeness","detail":"Public metadata needs stronger README/SKILL.md context"},{"status":"info","label":"Dependency/runtime risk","detail":"external package install surface, network or browser surface"},{"status":"pass","label":"Install availability","detail":"npx skills add jakubkrehel/skills --skill better-ui"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"info","label":"Permission surface","detail":"filesystem or document access, network or browser access"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/jakubkrehel/skills/tree/main/skills/better-ui"},{"status":"info","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"pass","label":"OpenAgentSkill usage","detail":"1 views, 0 install copies"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["AI review approved","Install path is available","Repository evidence is available","Recently maintained repository","Meaningful GitHub adoption signal","Install command has no obvious high-risk pattern"],"warnings":["SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval.","Quality score needs review"],"evidence":{"stars":"4.7K GitHub stars","repoActivity":"4.7K stars, 160 forks","lastPushed":"9d since push","license":"MIT","repository":"https://github.com/jakubkrehel/skills/tree/main/skills/better-ui","install":"npx skills add jakubkrehel/skills --skill better-ui","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, network or browser access","documentation":"Usable metadata, review docs","agentOutcomes":"No agent outcome data yet"},"installReadiness":{"ready":true,"command":"npx skills add jakubkrehel/skills --skill better-ui","policy":"sandbox_only","label":"Sandbox only","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","9d since push"]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval.","Quality score needs review"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"sandbox_only","reason":"Human review or sandbox validation is required before automatic installation."},"bestFor":["design-creative","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace","Live brokerage, exchange, wallet, or payment credentials outside an explicitly approved sandbox"],"knownRisks":["SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval.","Quality score needs review"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"outcome_stats":null,"safety":{"score":63,"level":"avoid_auto_install","label":"Avoid automatic install","safety_tier":{"tier":"blocked","label":"Blocked for auto-install","badge":"BLOCKED","summary":"This skill should not be selected by an agent without explicit human security review.","recommended_action":"Do not auto-install. Inspect the source, dependencies, and permission surface first.","auto_install_policy":"block","reasons":["Audit risk exceeds the requested agent policy","Audit classified this skill as risky","Audit risk risky exceeds max_risk=medium"]},"auto_install_allowed":false,"human_review_required":true,"blocked":true,"audit_risk":"risky","permission_hints":[{"id":"browser","label":"Browser automation","reason":"Skill may drive a browser or interact with web pages.","severity":"medium"},{"id":"network","label":"Network access","reason":"Skill likely fetches remote pages, APIs, repositories, or external services.","severity":"medium"},{"id":"filesystem","label":"Filesystem access","reason":"Skill may read or write project files, documents, generated artifacts, or local workspace state.","severity":"medium"}],"policy_warnings":["Audit risk risky exceeds max_risk=medium","Potential broker, wallet, exchange, or real-money execution surface; sandbox and explicit approval are required"],"constraints_applied":{"max_risk":"medium","needs_install_command":true,"min_stars":0}},"safety_gate":{"tier":"blocked","label":"Blocked for auto-install","badge":"BLOCKED","auto_install_policy":"block","auto_install_allowed":false,"blocked":true,"human_review_required":true,"recommended_action":"Do not auto-install. Inspect the source, dependencies, and permission surface first.","reasons":["Audit risk exceeds the requested agent policy","Audit classified this skill as risky","Audit risk risky exceeds max_risk=medium"]},"eval":{"version":"openagentskill-skill-eval-v1","status":"failed","score":77,"risk_level":"high","decision":{"recommendation":"do_not_auto_install","reason":"Audit score: Risky","auto_install_allowed":false,"policy":"block","human_review_required":true},"blockers":["Audit score: Risky","Agent safety gate: This skill should not be selected by an agent without explicit human security review."],"warnings":["Trust score: Good trust signals with a few areas worth checking before rollout.","README/SKILL.md completeness: Public metadata needs stronger README/SKILL.md context","Permission surface: filesystem or document access, network or browser access","Audit risk risky exceeds max_risk=medium","Potential broker, wallet, exchange, or real-money execution surface; sandbox and explicit approval are required","SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","The skill does not clearly state its limitations beyond a few offloaded topics; agents may apply UI polish rules outside the intended scope without guidance.","No tags or frameworks are declared in the SKILL.md metadata, which could reduce discoverability in agent skill catalogs.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval.","Quality score needs review"],"validation_plan":["Inspect repository, README/SKILL.md, license, and recent commits before production use.","Install in an isolated workspace or sandbox with no production secrets available.","Run the smallest representative task and record files touched, commands run, network access, and outputs.","Compare the selected skill against at least one alternative when the eval status is review or failed.","Promote only after the agent reports a successful verification result and unresolved warnings are accepted."],"checks":[{"id":"task_fit","label":"Task fit","status":"pass","score":84,"required_for_auto_install":true,"detail":"Task wording matches this skill metadata.","evidence":["Evaluate better-ui before installing it in an agent workflow","design-creative","Browser automation workflows; Claude Code teams; teams that value GitHub adoption signals"]},{"id":"install_path","label":"Install path","status":"pass","score":92,"required_for_auto_install":true,"detail":"Install handoff is available.","evidence":["npx skills add jakubkrehel/skills --skill better-ui"]},{"id":"install_safety","label":"Install command safety","status":"pass","score":92,"required_for_auto_install":true,"detail":"standard package or runtime install path","evidence":["npx skills add jakubkrehel/skills --skill better-ui"]},{"id":"trust_score","label":"Trust score","status":"warn","score":72,"required_for_auto_install":true,"detail":"Good trust signals with a few areas worth checking before rollout.","evidence":["Strong shortlist","4.7K GitHub stars","MIT"]},{"id":"audit_score","label":"Audit score","status":"fail","score":83,"required_for_auto_install":true,"detail":"Risky","evidence":["Potential broker, wallet, exchange, or real-money execution surface; sandbox and explicit approval are required"]},{"id":"agent_safety_gate","label":"Agent safety gate","status":"fail","score":63,"required_for_auto_install":true,"detail":"This skill should not be selected by an agent without explicit human security review.","evidence":["Do not auto-install. Inspect the source, dependencies, and permission surface first.","Audit risk exceeds the requested agent policy"]},{"id":"readme_skillmd_completeness","label":"README/SKILL.md completeness","status":"warn","score":76,"required_for_auto_install":false,"detail":"Public metadata needs stronger README/SKILL.md context","evidence":["Usable metadata, review docs"]},{"id":"license_clarity","label":"License clarity","status":"pass","score":86,"required_for_auto_install":true,"detail":"MIT","evidence":["MIT"]},{"id":"recent_maintenance","label":"Recent maintenance","status":"pass","score":100,"required_for_auto_install":false,"detail":"9d since push","evidence":["9d since push"]},{"id":"permission_surface","label":"Permission surface","status":"warn","score":72,"required_for_auto_install":true,"detail":"filesystem or document access, network or browser access","evidence":["Browser automation: medium","Network access: medium","Filesystem access: medium"]},{"id":"alternatives","label":"Alternatives available","status":"info","score":55,"required_for_auto_install":false,"detail":"No close alternatives were found in the current shortlist.","evidence":[]}],"endpoints":{"web":"https://www.openagentskill.com/skills/jakubkrehel-better-ui/evals","api":"/api/agent/evals?slug=jakubkrehel-better-ui","text":"/api/agent/evals?slug=jakubkrehel-better-ui&format=text"}},"agent_readable_metadata":{"version":"openagentskill-agent-metadata-v2","skill":{"slug":"jakubkrehel-better-ui","name":"better-ui","description":"Polishes and improves the UI in your project. Covers concentric border radius, optical alignment, surface depth, contextual icons, hit areas and more.","category":"design-creative","url":"https://www.openagentskill.com/skills/jakubkrehel-better-ui","repository":"https://github.com/jakubkrehel/skills/tree/main/skills/better-ui","github_repo":"jakubkrehel/skills"},"suited_tasks":["Browser automation workflows","Claude Code teams","teams that value GitHub adoption signals","Navigate pages","Click and type safely","Check visual and DOM state","Inspect repository metadata","Compare code changes"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI","Browser agents","CLI"],"install":{"command":"npx skills add jakubkrehel/skills --skill better-ui","ready":true,"targets":[{"id":"openagentskill-cli","label":"CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.3.0/openagentskill-0.3.0.tgz add jakubkrehel-better-ui"},{"id":"codex","label":"Codex","kind":"agent-prompt","value":"Install the \"better-ui\" agent skill from https://github.com/jakubkrehel/skills/tree/main/skills/better-ui. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Polishes and improves the UI in your project. Covers concentric border radius, optical alignment, surface depth, contextual icons, hit areas and more. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"jakubkrehel-better-ui\",\"task\":\"Install better-ui\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"claude-code","label":"Claude Code","kind":"agent-prompt","value":"Add \"better-ui\" as a Claude Code skill from https://github.com/jakubkrehel/skills/tree/main/skills/better-ui. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: Polishes and improves the UI in your project. Covers concentric border radius, optical alignment, surface depth, contextual icons, hit areas and more. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"jakubkrehel-better-ui\",\"task\":\"Install better-ui\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"cursor","label":"Cursor","kind":"agent-prompt","value":"Turn \"better-ui\" from https://github.com/jakubkrehel/skills/tree/main/skills/better-ui into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: Polishes and improves the UI in your project. Covers concentric border radius, optical alignment, surface depth, contextual icons, hit areas and more. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"jakubkrehel-better-ui\",\"task\":\"Install better-ui\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."}],"handoff_url":"https://www.openagentskill.com/api/skills/jakubkrehel-better-ui/install","manifest_url":"https://www.openagentskill.com/api/registry/manifest/jakubkrehel-better-ui"},"trust":{"score":72,"label":"Strong shortlist","version":"trust-score-v4","install_policy":"sandbox_only","evidence":{"stars":"4.7K GitHub stars","repoActivity":"4.7K stars, 160 forks","lastPushed":"9d since push","license":"MIT","repository":"https://github.com/jakubkrehel/skills/tree/main/skills/better-ui","install":"npx skills add jakubkrehel/skills --skill better-ui","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, network or browser access","documentation":"Usable metadata, review docs","agentOutcomes":"No agent outcome data yet"},"outcome_evidence":{"total":0,"successes":0,"failures":0,"not_relevant":0,"success_rate":null,"recent_success_rate":null,"recent_failure_rate":null,"install_attempts":0,"install_success_rate":null,"risk_blocked":0,"setup_required":0,"avg_output_quality":null,"production_outcomes":0,"last_outcome_at":null,"label":"No agent outcome data yet"},"auto_install":{"allowed":false,"sandbox_required":true,"reason":"Human review or sandbox validation is required before automatic installation."},"best_for":["design-creative","agent-skill"],"known_risks":["SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval.","Quality score needs review"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"audit":{"score":83,"risk_level":"risky","risk_label":"Risky","warnings":["Potential broker, wallet, exchange, or real-money execution surface; sandbox and explicit approval are required","SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","The skill does not clearly state its limitations beyond a few offloaded topics; agents may apply UI polish rules outside the intended scope without guidance.","No tags or frameworks are declared in the SKILL.md metadata, which could reduce discoverability in agent skill catalogs.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval.","Quality score needs review"]},"safety_gate":{"tier":"blocked","label":"Blocked for auto-install","auto_install_policy":"block","auto_install_allowed":false,"human_review_required":true,"blocked":true,"recommended_action":"Do not auto-install. Inspect the source, dependencies, and permission surface first."},"quality":{"score":84,"label":"Strong"},"supply":{"track":"Coding and developer agents","scenario":"GitHub automation","maintenance":"9d since push","risk":"Risky"},"alternative_skills":[],"do_not_use_when":["teams that need a vendor-supported SLA","production agents without a repository review","SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","Audit risk risky exceeds max_risk=medium","Potential broker, wallet, exchange, or real-money execution surface; sandbox and explicit approval are required","The skill does not clearly state its limitations beyond a few offloaded topics; agents may apply UI polish rules outside the intended scope without guidance.","No tags or frameworks are declared in the SKILL.md metadata, which could reduce discoverability in agent skill catalogs.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval."],"agent_contract":{"task_input":"Use better-ui in an agent workflow","recommended_action":"Do not auto-install. Inspect the source, dependencies, and permission surface first.","install_policy":"block","minimum_review_before_use":["Trust: 72/100 Strong shortlist","Audit: 83/100 Risky","Safety: 63/100 Avoid automatic install","Review repository, license, install command, and permission surface before production use."],"expected_agent_output":{"selected_skill":"jakubkrehel-better-ui (better-ui)","install_command":"npx skills add jakubkrehel/skills --skill better-ui","risk_summary":"Risky; Blocked for auto-install; Review before production","verification_result":"Report the smallest successful task, files touched, warnings, and any missing setup."}},"outcome_feedback":{"endpoint":"https://www.openagentskill.com/api/agent/outcome","method":"POST","requires_resolve_event_id":true,"event_id_source":"Use install_receipt.outcome_feedback.event_id or feedback.event_id returned by /api/agent/resolve for the current task.","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"payload_template":{"event_id":"<install_receipt.outcome_feedback.event_id or feedback.event_id from /api/agent/resolve>","skill_slug":"jakubkrehel-better-ui","task":"Use better-ui in an agent workflow","agent":"codex","outcome":"success","install_used":true,"risk_blocked":false,"setup_required":false,"task_success":true,"output_quality":4,"error_type":null,"human_review_required":false,"workspace":"sandbox","time_to_useful_ms":120000,"notes":"Report the smallest successful task, setup friction, files touched, and risk notes."}},"endpoints":{"web":"https://www.openagentskill.com/skills/jakubkrehel-better-ui","api":"https://www.openagentskill.com/api/agent/skills/jakubkrehel-better-ui","audit":"https://www.openagentskill.com/skills/jakubkrehel-better-ui/audit","eval":"https://www.openagentskill.com/api/agent/evals?slug=jakubkrehel-better-ui&task=Use%20better-ui%20in%20an%20agent%20workflow&max_risk=medium","resolve":"https://www.openagentskill.com/api/agent/resolve?task=Use%20better-ui%20in%20an%20agent%20workflow&agent=codex&max_risk=medium","receipt":"https://www.openagentskill.com/api/agent/receipt?task=Use%20better-ui%20in%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text","install":"https://www.openagentskill.com/api/skills/jakubkrehel-better-ui/install","manifest":"https://www.openagentskill.com/api/registry/manifest/jakubkrehel-better-ui"}},"machine_metadata":{"version":"openagentskill-agent-metadata-v2","skill":{"slug":"jakubkrehel-better-ui","name":"better-ui","description":"Polishes and improves the UI in your project. Covers concentric border radius, optical alignment, surface depth, contextual icons, hit areas and more.","category":"design-creative","url":"https://www.openagentskill.com/skills/jakubkrehel-better-ui","repository":"https://github.com/jakubkrehel/skills/tree/main/skills/better-ui","github_repo":"jakubkrehel/skills"},"suited_tasks":["Browser automation workflows","Claude Code teams","teams that value GitHub adoption signals","Navigate pages","Click and type safely","Check visual and DOM state","Inspect repository metadata","Compare code changes"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI","Browser agents","CLI"],"install":{"command":"npx skills add jakubkrehel/skills --skill better-ui","ready":true,"targets":[{"id":"openagentskill-cli","label":"CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.3.0/openagentskill-0.3.0.tgz add jakubkrehel-better-ui"},{"id":"codex","label":"Codex","kind":"agent-prompt","value":"Install the \"better-ui\" agent skill from https://github.com/jakubkrehel/skills/tree/main/skills/better-ui. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Polishes and improves the UI in your project. Covers concentric border radius, optical alignment, surface depth, contextual icons, hit areas and more. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"jakubkrehel-better-ui\",\"task\":\"Install better-ui\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"claude-code","label":"Claude Code","kind":"agent-prompt","value":"Add \"better-ui\" as a Claude Code skill from https://github.com/jakubkrehel/skills/tree/main/skills/better-ui. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: Polishes and improves the UI in your project. Covers concentric border radius, optical alignment, surface depth, contextual icons, hit areas and more. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"jakubkrehel-better-ui\",\"task\":\"Install better-ui\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"cursor","label":"Cursor","kind":"agent-prompt","value":"Turn \"better-ui\" from https://github.com/jakubkrehel/skills/tree/main/skills/better-ui into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: Polishes and improves the UI in your project. Covers concentric border radius, optical alignment, surface depth, contextual icons, hit areas and more. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"jakubkrehel-better-ui\",\"task\":\"Install better-ui\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."}],"handoff_url":"https://www.openagentskill.com/api/skills/jakubkrehel-better-ui/install","manifest_url":"https://www.openagentskill.com/api/registry/manifest/jakubkrehel-better-ui"},"trust":{"score":72,"label":"Strong shortlist","version":"trust-score-v4","install_policy":"sandbox_only","evidence":{"stars":"4.7K GitHub stars","repoActivity":"4.7K stars, 160 forks","lastPushed":"9d since push","license":"MIT","repository":"https://github.com/jakubkrehel/skills/tree/main/skills/better-ui","install":"npx skills add jakubkrehel/skills --skill better-ui","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, network or browser access","documentation":"Usable metadata, review docs","agentOutcomes":"No agent outcome data yet"},"outcome_evidence":{"total":0,"successes":0,"failures":0,"not_relevant":0,"success_rate":null,"recent_success_rate":null,"recent_failure_rate":null,"install_attempts":0,"install_success_rate":null,"risk_blocked":0,"setup_required":0,"avg_output_quality":null,"production_outcomes":0,"last_outcome_at":null,"label":"No agent outcome data yet"},"auto_install":{"allowed":false,"sandbox_required":true,"reason":"Human review or sandbox validation is required before automatic installation."},"best_for":["design-creative","agent-skill"],"known_risks":["SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval.","Quality score needs review"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"audit":{"score":83,"risk_level":"risky","risk_label":"Risky","warnings":["Potential broker, wallet, exchange, or real-money execution surface; sandbox and explicit approval are required","SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","The skill does not clearly state its limitations beyond a few offloaded topics; agents may apply UI polish rules outside the intended scope without guidance.","No tags or frameworks are declared in the SKILL.md metadata, which could reduce discoverability in agent skill catalogs.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval.","Quality score needs review"]},"safety_gate":{"tier":"blocked","label":"Blocked for auto-install","auto_install_policy":"block","auto_install_allowed":false,"human_review_required":true,"blocked":true,"recommended_action":"Do not auto-install. Inspect the source, dependencies, and permission surface first."},"quality":{"score":84,"label":"Strong"},"supply":{"track":"Coding and developer agents","scenario":"GitHub automation","maintenance":"9d since push","risk":"Risky"},"alternative_skills":[],"do_not_use_when":["teams that need a vendor-supported SLA","production agents without a repository review","SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","Audit risk risky exceeds max_risk=medium","Potential broker, wallet, exchange, or real-money execution surface; sandbox and explicit approval are required","The skill does not clearly state its limitations beyond a few offloaded topics; agents may apply UI polish rules outside the intended scope without guidance.","No tags or frameworks are declared in the SKILL.md metadata, which could reduce discoverability in agent skill catalogs.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval."],"agent_contract":{"task_input":"Use better-ui in an agent workflow","recommended_action":"Do not auto-install. Inspect the source, dependencies, and permission surface first.","install_policy":"block","minimum_review_before_use":["Trust: 72/100 Strong shortlist","Audit: 83/100 Risky","Safety: 63/100 Avoid automatic install","Review repository, license, install command, and permission surface before production use."],"expected_agent_output":{"selected_skill":"jakubkrehel-better-ui (better-ui)","install_command":"npx skills add jakubkrehel/skills --skill better-ui","risk_summary":"Risky; Blocked for auto-install; Review before production","verification_result":"Report the smallest successful task, files touched, warnings, and any missing setup."}},"outcome_feedback":{"endpoint":"https://www.openagentskill.com/api/agent/outcome","method":"POST","requires_resolve_event_id":true,"event_id_source":"Use install_receipt.outcome_feedback.event_id or feedback.event_id returned by /api/agent/resolve for the current task.","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"payload_template":{"event_id":"<install_receipt.outcome_feedback.event_id or feedback.event_id from /api/agent/resolve>","skill_slug":"jakubkrehel-better-ui","task":"Use better-ui in an agent workflow","agent":"codex","outcome":"success","install_used":true,"risk_blocked":false,"setup_required":false,"task_success":true,"output_quality":4,"error_type":null,"human_review_required":false,"workspace":"sandbox","time_to_useful_ms":120000,"notes":"Report the smallest successful task, setup friction, files touched, and risk notes."}},"endpoints":{"web":"https://www.openagentskill.com/skills/jakubkrehel-better-ui","api":"https://www.openagentskill.com/api/agent/skills/jakubkrehel-better-ui","audit":"https://www.openagentskill.com/skills/jakubkrehel-better-ui/audit","eval":"https://www.openagentskill.com/api/agent/evals?slug=jakubkrehel-better-ui&task=Use%20better-ui%20in%20an%20agent%20workflow&max_risk=medium","resolve":"https://www.openagentskill.com/api/agent/resolve?task=Use%20better-ui%20in%20an%20agent%20workflow&agent=codex&max_risk=medium","receipt":"https://www.openagentskill.com/api/agent/receipt?task=Use%20better-ui%20in%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text","install":"https://www.openagentskill.com/api/skills/jakubkrehel-better-ui/install","manifest":"https://www.openagentskill.com/api/registry/manifest/jakubkrehel-better-ui"}},"supply_profile":{"track":{"slug":"coding","label":"Coding and developer agents","shortLabel":"Coding","description":"Code review, repo analysis, testing, CI, GitHub, DevOps, and developer workflow skills."},"scenario":{"label":"GitHub automation","description":"I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.","useCases":[{"slug":"browser-automation","title":"Browser automation"},{"slug":"github-automation","title":"GitHub automation"},{"slug":"coding-agents","title":"Coding agents"}]},"applicableAgents":["Claude Code","Browser agents","CLI","Codex","Cursor"],"install":{"ready":true,"command":"npx skills add jakubkrehel/skills --skill better-ui","primaryTarget":"CLI","targetCount":4},"githubQuality":{"stars":4744,"starsLabel":"4.7K","forks":160,"license":"MIT","qualityScore":84,"trustScore":72,"auditScore":83},"maintenance":{"status":"fresh","label":"9d since push","daysSincePush":9,"lastPushedAt":"2026-08-29T17:01:49+00:00"},"risk":{"level":"risky","label":"Risky","requiresReview":true,"notes":["Potential broker, wallet, exchange, or real-money execution surface; sandbox and explicit approval are required","SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","The skill does not clearly state its limitations beyond a few offloaded topics; agents may apply UI polish rules outside the intended scope without guidance.","No tags or frameworks are declared in the SKILL.md metadata, which could reduce discoverability in agent skill catalogs.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval."]},"coverageTags":["Coding","GitHub automation","design-creative","agent-skill"]},"audit":{"audit_score":83,"risk_level":"risky","risk_label":"Risky","quality_score":84,"trust_score":72,"maintenance_score":100,"security_score":79,"install_score":92,"warnings":["Potential broker, wallet, exchange, or real-money execution surface; sandbox and explicit approval are required","SKILL.md is primarily a design reference rather than an explicit agent workflow; it lacks a defined usage section with inputs, outputs, and setup instructions.","The skill does not clearly state its limitations beyond a few offloaded topics; agents may apply UI polish rules outside the intended scope without guidance.","No tags or frameworks are declared in the SKILL.md metadata, which could reduce discoverability in agent skill catalogs.","This skill may touch real-money trading, broker, wallet, or exchange operations; use only in a sandbox with explicit approval.","Quality score needs review"]},"quality_signals":{"model":"v2","star_score":25.73,"usage_score":0,"review_score":5.25,"metadata_score":3,"freshness_score":15},"platforms":["Claude Code","Browser agents"],"use_cases":[{"slug":"browser-automation","title":"Browser automation","url":"https://www.openagentskill.com/use-cases/browser-automation"},{"slug":"github-automation","title":"GitHub automation","url":"https://www.openagentskill.com/use-cases/github-automation"},{"slug":"coding-agents","title":"Coding agents","url":"https://www.openagentskill.com/use-cases/coding-agents"},{"slug":"rag-knowledge","title":"RAG and knowledge","url":"https://www.openagentskill.com/use-cases/rag-knowledge"}],"stacks":[{"slug":"browser-qa-agent","title":"Browser QA agent","url":"https://www.openagentskill.com/collections/browser-qa-agent"},{"slug":"frontend-product-ui","title":"Frontend and UI","url":"https://www.openagentskill.com/collections/frontend-product-ui"},{"slug":"coding-review-agent","title":"Coding review agent","url":"https://www.openagentskill.com/collections/coding-review-agent"}],"install":"npx skills add jakubkrehel/skills --skill better-ui","install_targets":[{"id":"openagentskill-cli","label":"CLI","title":"OpenAgentSkill CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.3.0/openagentskill-0.3.0.tgz add jakubkrehel-better-ui","description":"Resolve policy, run the source installer safely, and report a verified install receipt.","copyLabel":"Copy command"},{"id":"codex","label":"Codex","title":"Codex install prompt","kind":"agent-prompt","value":"Install the \"better-ui\" agent skill from https://github.com/jakubkrehel/skills/tree/main/skills/better-ui. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Polishes and improves the UI in your project. Covers concentric border radius, optical alignment, surface depth, contextual icons, hit areas and more. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"jakubkrehel-better-ui\",\"task\":\"Install better-ui\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Give Codex a repo-aware install prompt when the skill is not available through a local CLI.","copyLabel":"Copy prompt"},{"id":"claude-code","label":"Claude Code","title":"Claude Code skill prompt","kind":"agent-prompt","value":"Add \"better-ui\" as a Claude Code skill from https://github.com/jakubkrehel/skills/tree/main/skills/better-ui. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: Polishes and improves the UI in your project. Covers concentric border radius, optical alignment, surface depth, contextual icons, hit areas and more. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"jakubkrehel-better-ui\",\"task\":\"Install better-ui\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Use this prompt to ask Claude Code to add the skill and explain the local activation steps.","copyLabel":"Copy prompt"},{"id":"cursor","label":"Cursor","title":"Cursor rule prompt","kind":"agent-prompt","value":"Turn \"better-ui\" from https://github.com/jakubkrehel/skills/tree/main/skills/better-ui into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: Polishes and improves the UI in your project. Covers concentric border radius, optical alignment, surface depth, contextual icons, hit areas and more. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"jakubkrehel-better-ui\",\"task\":\"Install better-ui\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Use this when installing as Cursor project rules or reusable agent instructions.","copyLabel":"Copy prompt"}],"repository":"https://github.com/jakubkrehel/skills/tree/main/skills/better-ui","github_repo":"jakubkrehel/skills","version":"1.0.0","license":"MIT","urls":{"web":"https://www.openagentskill.com/skills/jakubkrehel-better-ui","repository":"https://github.com/jakubkrehel/skills/tree/main/skills/better-ui","api":"/api/agent/skills/jakubkrehel-better-ui","install_api":"/api/skills/jakubkrehel-better-ui/install"},"meta":{"created_at":"2026-09-02T06:15:14.92224+00:00","updated_at":"2026-09-02T06:15:15.002726+00:00","agent_friendly":true}}