@nstudio/nativescript-agent-skills

NativeScript Agent Skills

Reusable, code-first Agent Skills for AI coding agents (Claude Code, Cursor, Codex, Copilot, Gemini CLI and any other client of the open standard) working on NativeScript projects. Each skill is a folder with a SKILL.md: a one-line description the agent matches on, then concrete TypeScript that has actually run, plus the pitfalls around it.

Install

Pick the door that matches your setup — they all serve the same skills/ tree.

You use…	Install	Update
Any agent (Claude Code, Cursor, Codex, Copilot, Gemini, Windsurf, …)	npx skills add nstudio/nativescript-agent-skills (add --copy to vendor real files, -g for global)	npx skills update
Claude Code plugin	/plugin marketplace add nstudio/nativescript-agent-skills then /plugin install nativescript-agent-skills@nstudio	/plugin update nativescript-agent-skills@nstudio
npm, vendored & pinned in your repo	npx @nstudio/nativescript-agent-skills install --agent claude,agents (writes .nativescript-agent-skills.json)	npx @nstudio/nativescript-agent-skills@latest update (check shows stale/modified files)
TanStack Intent	npm i -D @nstudio/nativescript-agent-skills && npx @tanstack/intent@latest install	npm update @nstudio/nativescript-agent-skills
By hand	cp -R skills/ns-liquid-glass-panel <project>/.claude/skills/ (or ~/.claude/skills/)	cp again

Details, trade-offs and the release process: docs/DISTRIBUTION.md.

Skills

Skill	Use it when…
ns-ios-scenekit-from-typescript	you need real-time 3D on iOS: SCNView in a custom View, textures, Metal shader modifiers, hit testing, camera framing
ns-ios-cadisplaylink-render-loop	you need a 60fps JS tick on iOS — the CADisplayLink target that actually fires under NativeScript
ns-ios-framework-typings	TS can't find SCNView/CLLocation/CMMotionManager… — reference the framework d.ts, grep exact selectors, read the SDK header
ns-custom-view-platform-split	you're building a custom view with a different native renderer per platform (common/ios/android/d.ts, shared gestures + Properties, Angular registration)
ns-android-canvas-custom-view	you need custom 60fps 2D drawing on Android (android.view.View subclass, onDraw, Choreographer, batching + perf findings)
ns-android-java-interop-gotchas	you hit "Cannot marshal JavaScript argument", "Failed resolving method", "Class constructor … cannot be invoked without 'new'", or wrong 8-digit hex colours on Android
ns-liquid-glass-panel	you want a frosted/glass panel: UIGlassEffect on iOS 26, UIBlurEffect earlier, translucent drawable on Android; the GridLayout layering trick
ns-ios-bottom-sheet-native	you want a real UISheetPresentationController sheet (detents, grabber, glass) — and when an in-page panel is the better call
ns-no-intl-native-formatting	numbers/dates format wrong because the iOS runtime has no Intl — NSDateFormatter/SimpleDateFormat with time zones
ns-corelocation-direct	you need location/heading without a plugin: CLLocationManager delegate class, Android LocationManager, simulator setup
ns-clgeocoder-place-and-timezone	you need "what place is this coordinate and what time is it there" — CLGeocoder + CLPlacemark.timeZone, Android Geocoder, ocean fallback
ns-haptics-direct	you want tactile feedback: UIFeedbackGenerator / VibrationEffect
ns-angular-zoneless-native-choreography	you're wiring zoneless Angular signals to native views with polished motion (animate() intros, dimming, crossfades, SegmentedBar on iOS + custom animated tabs on Android)
ns-ios-simulator-automation	you're verifying an app on the iOS simulator/Android emulator from the shell: screenshots, frame-by-frame video, taps/swipes, locating tap targets, fake location, permissions, logs
ns-animated-panel-height	a panel/sheet body must grow/shrink smoothly with its content on both platforms (explicit measure + animated height; Android layoutChanged/ScrollView traps)
ns-app-icons-and-launch-assets	the app still shows the template icon/launch screen — generate and install icons on both platforms (bundled scripts/make-icon.py, scripts/install-icons.sh)
ns-iss-tracking-satellite-js	you need live satellite/ISS position, ground track, sunlit state, or visible-pass predictions
ns-solar-terminator-math	you need the sun from the clock: subsolar point, elevation, day phase, sunrise/sunset — dependency-free
ns-webpack-angular-project-notes	you're setting up or debugging an ns create --ng project (tsconfig, assets, ATS, plist/manifest, log noise)
ns-angular-vite-migration	you're moving a NativeScript Angular project from webpack to @nativescript/vite (working version set, bundled analogjs patch, configs, NG0210 + Android FORTIFY launch crashes)
ns-norrix-ota	you're adding OTA updates via @norrix/client-sdk — the peer-dep install trap, the wrapper util (dev gating, deferred init, sync()), and the overlay-teardown-before-reload rule that prevents the post-apply black screen
ns-input-accessory	you're docking a chat/composer/search bar to the keyboard with @nativescript/input-accessory in any flavor — the ScrollView + container + TextView contract, setup() with real geometry (the ≤50pt → 48 squeeze), line-height text centering via style padding, tab-bar and IQKeyboardManager exclusions, Android gesture-nav inset, suspend/restore around sheets (bundled 1.0.3 patch)

Verified environment: macOS, Xcode 26.5, iOS 26.5 simulator, Android emulator Pixel 6a API 35 (SwiftShader), NativeScript CLI 9.1, @nativescript/core 9.1.

Quality

• npm run lint — Agent Skills spec lint; npm run validate — TanStack Intent's validator. Both run in CI.
• evals/ — a skillgrade suite with one realistic task per skill, executable graders where the code can run headless, and a check that the agent actually discovered the skill. See evals/README.md and the latest report in docs/EVALUATION.md.

Contributing a skill

skills/<name>/SKILL.md with name (== folder), description starting "Use when …", license, metadata; code that has run, with the environment it was verified in; keep it under ~150 lines and put large helpers in scripts/ or assets/. Add a task to evals/tasks.mjs. npm run check before opening a PR.

License

MIT © nstudio