# yetone/native-feel-skill

An Agent Skill for designing cross-platform desktop apps that feel native — distilled from Raycast's 2.0 deep-dive and reverse engineering of Raycast Beta.app. Eight architectural tenets, four-layer architecture, WebKit/WebView2 survival guide, 75-item ship audit.

Repository: https://github.com/yetone/native-feel-skill
Canonical: https://ross.abutalabs.com/products/native-feel-skill
License: MIT
License Family: permissive
Last push: 2026-05-30T15:12:34+00:00

## Health v2 (maintenance only)
Score: 52/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 85, release rhythm 35, longevity 7
- inputs: {"age_days": 111, "days_push": 95, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1899, forks 73 (observed 2026-08-28T04:05:51.388073+00:00)

## What it is
An Agent Skill (SKILL.md package) that teaches AI agents how to design cross-platform desktop apps that feel native, distilled from Raycast's 2.0 deep-dive and reverse engineering of the Raycast Beta binary. It bundles eight architectural tenets, a four-layer architecture, a WebKit/WebView2 survival guide, and a 75-item ship-readiness audit.

## Use cases
- make my electron app feel native on macos
- refactor a tauri app to pass as a real mac app
- design a cross-platform desktop app with near-native performance
- audit my webview app for web-y ui mistakes
- learn webkit and webview2 quirks for desktop apps
- get a ship-readiness checklist for a desktop app
- guide an ai agent to build native-feeling desktop ui

## When to choose
- you are building or refactoring an Electron/Tauri/WebView-based desktop app that should feel native
- you use an AI coding agent that supports Agent Skills and want it to apply native-feel design principles
- you want a concrete audit checklist of common web-style UI mistakes in desktop apps

## When to avoid
- you are building a truly native app with SwiftUI, AppKit, or WinUI rather than a web-based stack
- you need runnable code or a framework rather than guidance, checklists, and documentation
- your project has no desktop UI component

## Facets
- artifact type: learning-resource
- maturity: active
- function: documentation, developer-tools, desktop-framework
- domain: desktop-applications, cross-platform, developer-tools, tutorials
- platform: windows, cross-platform
- tags: agent-skill, electron, tauri, webview, native-ui, raycast, design-guidelines, checklist, macos

## Member repositories
- yetone/native-feel-skill (main) score 52

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:51.388073+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:12:12.013395+00:00, confidence not recorded.
  - readme: https://github.com/yetone/native-feel-skill (fetched 2026-08-28T04:05:51.388073+00:00, sha 9858e791074d)
- Data as of 2026-08-30T08:39:29.467469+00:00.