Harper Agent Skills
This repository provides specialized "skills" for AI agents (like Cursor, Windsurf, or Junie) to build better applications on Harper .
Installation
GH Skills
Make sure you have the GitHub CLI installed, then you can skill add and skill update these skills:
brew install gh
gh skill add harperfast/skills
gh skill update copy
NPX Skills
Add these skills to your local project using the skills CLI:
npx skills add harperfast/skills copy
Re-run this command later if you want to get the latest updates from us.
Manual Installation
If your corporate network prevents the skills CLI from downloading the skills, you can install them manually:
Download the repository as a ZIP file from GitHub (Code > Download ZIP).
Extract the contents of the ZIP file.
Copy the skill folders (e.g., harper-best-practices) into your project's agent configuration directory:
Junie, Cursor, Windsurf: .agent/skills
Claude Desktop: .claude/skills
Other Agents: Refer to your agent's documentation for its skills/rules directory.
Available Skills
Comprehensive guidelines for building, extending, and deploying Harper applications. Covers:
Schema design and relationships.
Automatic REST and WebSocket APIs.
Custom resources and table extensions.
Advanced features like Vector Indexing and Caching.
Running Harper on a developer machine. Covers:
Running several Harper dev instances side by side, one per git worktree or agent session.
Per-instance loopback addresses and data roots, with a ready-to-copy npm run dev wrapper.
Comprehensive guide to Harper's Model Context Protocol (MCP) interface. Covers:
Enabling the MCP server profiles and connecting AI clients.
Automatic CRUD verb tools and custom mcpTools / mcpPrompts / mcpResources.
The resources surface (harper://, harper+rest://, custom URIs and templates).
Rate limiting, durable quotas, and the security model for public endpoints.
How it Works
These skills are structured to be easily consumed by Large Language Models (LLMs) and AI agents. For a technical overview of how agents use these files, see AGENTS.md .