usemoss/moss/moss-pikachu

Claude Code and agent skill by usemoss/moss

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Build and maintain Moss Pikachu, a macOS menu bar semantic file search app using Moss Python SDK (PyPI moss>=1.6.0), FSEvents, SwiftUI, and Pikachu pet animations. Use when working on MossPikachu, moss_worker.py, FileMonitor, SearchService, menu bar overlay, or Moss integration in this repository.

Install

npx vskill@latest install usemoss/moss/moss-pikachu

SKILL.md

Moss Pikachu Agent Skill

Project docs (start here)

DocPurpose
project-summary.mdFull technical reference
how-to.mdEnd-user guide
contribution.mdContributor guide

Specialized skills

SkillUse when
moss-pikachu-semantic-searchSearch quality, query tuning
moss-pikachu-indexingIndexing, manual/automatic modes
moss-pikachu-contributingPRs and contribution workflow

Read order

  1. architecture.md
  2. moss-integration.md
  3. macos-patterns.md
  4. ui-animations.md
  5. pitfalls.md

Non-negotiables

  • Xcode `.app` bundle — not a root-level SPM executable for the menu bar app
  • macOS-only target — SUPPORTED_PLATFORMS = macosx
  • Python worker for Moss on macOS — Moss Swift SPM is iOS-only
  • `pip install moss>=1.6.0` — GitHub main sdks/python/sdk lacks SessionIndex API
  • No hardcoded credentials — MOSS_PROJECT_ID / MOSS_PROJECT_KEY via Keychain or env
  • NSPanel for search overlay — not WindowGroup (avoids Dock icon)

Phase gates

Run before advancing phases:

bash
./.cursor/skills/moss-pikachu/scripts/validate-phase.sh 1
./.cursor/skills/moss-pikachu/scripts/validate-phase.sh 2
./.cursor/skills/moss-pikachu/scripts/validate-phase.sh 3

Task sequencing

PhaseScope
1Menu bar, hotkey, search overlay shell, settings window
2FileMonitor, moss_worker.py, MossBridge, SearchService
3Pikachu animations, live search UI, settings, polish

Do not wire live search before MossBridge + SearchService compile and pass Phase 2 validation.

Code conventions

  • @MainActor for all UI updates
  • async/await for MossBridge calls (not callbacks)
  • Line-delimited JSON between Swift and Python (\n terminated)
  • Debounce FSEvents (100ms) and search input (200ms)
  • MARK: sections in Swift service files

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/usemoss/moss/moss-pikachu/badge)](https://verified-skill.com/skills/usemoss/moss/moss-pikachu)

Something wrong with this skill or its page? Tell us.