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.
The Native Feel Skill is an Agent Skill that teaches AI assistants how to architect cross-platform desktop applications with native performance and feel. Distilled from Raycast's technical deep-dive and reverse engineering of Raycast Beta, it provides eight architectural tenets, a four-layer architecture (native shell → WebView → Node → Rust), WebKit/WebView2 survival guides, and a 75-item shipping audit. Once installed, it activates automatically when conversations touch cross-platform desktop architecture, helping agents advise on WebView quirks, IPC contracts, memory optimization, and native UI conventions for macOS and Windows applications.
Key Features
Use Cases
- 01Refactoring an Electron or Tauri app to eliminate web-style tells and achieve native macOS/Windows feel
- 02Building a greenfield cross-platform desktop app (launcher, productivity tool, AI workspace) with native polish
- 03Debugging WKWebView flickering, throttling, or rendering issues in hybrid desktop applications
- 04Designing typed IPC schemas for polyglot desktop architectures spanning multiple runtimes
- 05Auditing a desktop app against 70+ native UI conventions before shipping
- 06Optimizing memory usage and cold-start performance for WebView-based desktop applications
Related Skills
View moresuperpowers
An agentic skills framework & software development methodology that works.
skills
Skills for Real Engineers. Straight from my .agents directory.
skills
Public repository for Agent Skills
ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
native-feel-skill — FAQ
What is the Native Feel Skill?+
It's an Agent Skill that packages architectural knowledge for building cross-platform desktop apps that feel native. AI agents like Claude Code automatically reference it when you discuss desktop architecture, WebView issues, or Raycast-style applications.
How do I install the Native Feel Skill?+
Install globally with npx skills add yetone/native-feel-skill -g, or clone the repo to your agent's skills directory (e.g. ~/.claude/skills/native-feel-cross-platform-desktop/ for Claude Code). The skill activates automatically once the SKILL.md and reference files are in place.
Which AI clients work with this skill?+
Any Agent-Skill-aware runtime, including Claude Code and agents built with the Claude Agent SDK. The skill follows the emerging Agent Skills standard for domain-knowledge packaging.
Do I need API keys or prerequisites?+
No API keys required. You need an Agent-Skill-compatible AI client and familiarity with cross-platform desktop development (Electron, Tauri, or native + WebView hybrids).
Is the Native Feel Skill free?+
Yes, it's open source under the MIT license. The architectural guidance, checklists, and reference materials are freely available on GitHub.
What kinds of apps is this architecture suited for?+
macOS/Windows apps requiring native feel with plugin ecosystems (launchers, productivity tools, AI workspaces). It's not suited for single-OS apps, strict sub-150MB budgets, or apps with sub-100ms cold-start requirements—run the decision tree first.
How do I install native-feel-skill?+
Open the source repository on GitHub and follow its README. native-feel-skill is a skill — MCP Agents Market links you directly to the official repo.
Is native-feel-skill free?+
native-feel-skill is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.