@triedotdev/mcp 1.0.40 → 1.0.42

package/README.md

@@ -1,10 +1,8 @@
 # Trie
 
-**Customizable Parallel Agents for AI Code Review**
+**A central registry for agents and skills that follow you from Cursor to CI/CD and everything in between.**
 
-Specialized agents scan your code for security, privacy, compliance, and bugs—all running in parallel with intelligent caching and real-time streaming.
-
-Also try the agentic workspace for shipping AI-generated code: https://www.trie.dev
+Download the Trie workspace: https://www.trie.dev
 
 ## Why Trie
 
@@ -14,6 +12,8 @@ The last mile of shipping is where things break—not because your code doesn't
 
 ## What's New (latest updates)
 
+- **External Skills**: Install reusable capabilities from Vercel, Anthropic, Expo, Stripe, Supabase, or any GitHub repository. Skills are applied by the skill-review agent during scans and tracked in your project context. Browse available skills at [skills.sh](https://skills.sh).
+
 - **Project Info Registry**: Store important project context in `.trie/PROJECT.md` that travels with you across Claude Code, Cursor, GitHub Actions, and CLI. Define your project description, tech stack, conventions, architecture, and custom AI instructions—all in one place.
 
 - **Accessibility Agent (v2.0)**: Comprehensive WCAG 2.1 AA compliance. Detects icon-only buttons, touch targets, skipped headings, positive tabIndex, ARIA validation, color-only indicators, and 20+ more checks with WCAG criterion references.
@@ -40,12 +40,13 @@ The last mile of shipping is where things break—not because your code doesn't
 - [Design Engineer (v2.0)](#design-engineer-v20)
 - [Special Agents](#special-agents)
 - [Custom Agents](#custom-agents)
+- [External Skills](#external-skills)
 - [Project Info Registry](#project-info-registry)
 - [AI-Enhanced Mode](#ai-enhanced-mode)
 - [CI/CD Integration](#cicd-integration)
 - [VS Code Extension](#vs-code-extension)
 - [Agent Context System](#agent-context-system)
-- [Production Shipping](#production-shipping) (Production Ready Agent)
+- [Production Shipping](#production-shipping)
 - [Configuration](#configuration)
 - [License](#license)
 
@@ -69,6 +70,7 @@ The last mile of shipping is where things break—not because your code doesn't
 |---------|-------------|
 | **Watch Mode** | Automatically scan files as you code |
 | **Custom Agents** | Create agents from PDFs, docs, or style guides |
+| **External Skills** | Install capabilities from Vercel, Anthropic, Expo, Stripe, or any GitHub repo |
 | **Works Everywhere** | Auto-detects Cursor, Claude Code, OpenCode, VS Code—adapts output automatically |
 | **AI-Enhanced Mode** | Optional deeper analysis with `ANTHROPIC_API_KEY` |
 
@@ -223,7 +225,7 @@ Once set up, here's how to use Trie day-to-day.
 | What Trie Remembers | Why It Matters |
 |---------------------|----------------|
 | Last scan results | AI knows what issues exist without re-scanning |
-| **Health score (0-100)** | Controls what agents run (see below) |
+| Health score (0-100) | Controls what agents run (see below) |
 | Which files have issues | AI focuses on problem areas first |
 | What type of code you have | Runs the right checks (payments, auth, etc.) automatically |
 | Scan history | See if issues are getting better or worse |
@@ -454,6 +456,12 @@ trie-agent scan --format json --output report.json
 
 # List all available agents
 trie-agent agents
+
+# Install an external skill
+trie-agent skills add vercel-labs/agent-skills react-best-practices
+
+# List installed skills
+trie-agent skills list
 ```
 
 ### CLI vs MCP Tools
@@ -949,6 +957,130 @@ Custom agents are stored in `.trie/agents/` in your project directory.
 
 ---
 
+## External Skills
+
+Install reusable capabilities from Vercel, Anthropic, Expo, Stripe, Supabase, or any GitHub repository. Skills are knowledge/instructions that agents apply during code review.
+
+### Key Concept: Agents vs Skills
+
+| | Agent (Brain) | Skill (Hands) |
+|---|---------------|---------------|
+| **Decides when to run** | Yes | No - invoked by agent |
+| **Has its own logic** | Yes | No - just instructions |
+| **Makes decisions** | Yes | No - follows instructions |
+| **Examples** | SecurityAgent, CustomAgent | react-best-practices SKILL.md |
+
+Skills are applied by the **skill-review agent** during scans.
+
+### Install a Skill
+
+**CLI:**
+```bash
+# From Vercel's skills repository
+trie-agent skills add vercel-labs/agent-skills react-best-practices
+
+# From Anthropic's skills
+trie-agent skills add anthropics/skills claude-code-review
+
+# From any GitHub repo with a SKILL.md
+trie-agent skills add myorg/internal-standards code-style
+```
+
+**Using MCP (Cursor/Claude Code):**
+```
+Install the react-best-practices skill from vercel-labs/agent-skills
+```
+
+### List Installed Skills
+
+```bash
+trie-agent skills list
+```
+
+Output:
+```
+Installed Skills (2):
+
+  react-best-practices (applied 12x)
+    React and Next.js performance optimization
+    Source: vercel-labs/agent-skills
+
+  web-design-guidelines (applied 8x)
+    Modern web design patterns and accessibility
+    Source: vercel-labs/agent-skills
+
+These skills are applied by the skill-review agent during scans.
+```
+
+### How It Works
+
+1. **Install** - Skills are cloned from GitHub to `.trie/skills/`
+2. **Load** - The skill-review agent loads installed skills on startup
+3. **Apply** - During scans, the agent applies skill knowledge to code review
+4. **Track** - Usage is recorded in your project context
+
+### Remove a Skill
+
+```bash
+trie-agent skills remove react-best-practices
+```
+
+### Skill Format
+
+Skills follow the [Agent Skills specification](https://agentskills.io/specification):
+
+```
+skill-name/
+  SKILL.md          # Required: YAML frontmatter + instructions
+  scripts/          # Optional: executable code
+  references/       # Optional: additional docs
+  assets/           # Optional: templates, data
+```
+
+Example SKILL.md:
+```yaml
+---
+name: react-best-practices
+description: React and Next.js performance optimization
+---
+
+# React Best Practices
+
+## Guidelines
+1. Avoid creating components inside render
+2. Use React.memo for expensive components
+3. Prefer useCallback for event handlers
+...
+```
+
+### MCP Resource
+
+Access installed skills via MCP:
+```
+Read trie://skills
+```
+
+### Skill Sources
+
+Skills can come from any GitHub repository with a SKILL.md file:
+
+| Source | Examples |
+|--------|----------|
+| [Vercel](https://github.com/vercel-labs/agent-skills) | react-best-practices, web-design-guidelines |
+| [Anthropic](https://github.com/anthropics/skills) | frontend-design, skill-creator, webapp-testing |
+| [Expo](https://github.com/expo/skills) | building-native-ui, upgrading-expo, native-data-fetching |
+| [Stripe](https://github.com/stripe/ai) | stripe-best-practices |
+| [Better Auth](https://github.com/better-auth/skills) | better-auth-best-practices |
+| [Remotion](https://github.com/remotion-dev/skills) | remotion-best-practices |
+| [Callstack](https://github.com/callstackincubator/agent-skills) | react-native-best-practices |
+| [Supabase](https://github.com/supabase/agent-skills) | supabase-postgres-best-practices |
+| Your org | Internal standards, style guides, compliance docs |
+| Community | Any public repo following the SKILL.md format |
+
+Browse all available skills at [skills.sh](https://skills.sh)
+
+---
+
 ## Project Info Registry
 
 Store important project-specific information in `.trie/PROJECT.md` that's automatically available to all AI tools.