Claude Code Marketplace - NPM Test Subagent

A Claude Code marketplace package containing a specialized npm-test subagent for running and analyzing npm tests.

What's Included

npm-test Subagent

A specialized AI agent designed to:

• Run npm test commands
• Analyze test results and failures
• Provide detailed test summaries
• Suggest fixes for failing tests

Installation

From npm (Recommended)

The package automatically creates a symlink to a deterministic location during installation.

Step 1: Install from npm (locally or globally)

# Local install (recommended for project-specific use)
npm install claude-code-marketplace-npm-test

# Or global install (available system-wide)
npm install -g claude-code-marketplace-npm-test

The postinstall script automatically creates a symlink at:

~/.claude/marketplaces/marketplace-npm-test

Step 2: Add the marketplace in Claude Code

/plugin marketplace add ~/.claude/marketplaces/marketplace-npm-test

Step 3: Install the plugin

/plugin install npm-test@marketplace-npm-test

That's it! The path is now deterministic and will always be the same location.

Alternative: From GitHub

If hosted on GitHub:

/plugin marketplace add owner/marketplace-npm
/plugin install npm-test@marketplace-npm-test

Manual Local Installation

For development or testing:

/plugin marketplace add /path/to/marketplace-npm
/plugin install npm-test@marketplace-npm-test

See INSTALLATION.md for detailed installation instructions and troubleshooting.

Usage

Once installed, you can invoke the npm-test subagent in Claude Code using the Task tool:

Use the npm-test agent to run my tests

Or Claude Code will automatically suggest using it when you mention testing tasks.

Subagent Details

Name: npm-test Tools: Bash, Read, Grep, Glob Purpose: Specialized testing agent for npm-based projects

Capabilities

• Executes test commands (npm test, npm run test:unit, etc.)
• Parses test output and identifies failures
• Reads test files and configuration
• Searches for specific test cases
• Provides actionable recommendations

Directory Structure

marketplace-npm/
├── .claude-plugin/
│   └── marketplace.json      # Marketplace catalog
├── plugins/
│   └── npm-test/             # npm-test plugin
│       ├── .claude-plugin/
│       │   └── plugin.json   # Plugin manifest
│       └── agents/
│           └── npm-test.md   # npm-test subagent definition
├── README.md                 # This file
└── package.json              # Package metadata

Creating Your Own Subagents

Subagents are Markdown files with YAML frontmatter. Here's the basic structure:

---
name: your-agent-name
description: What your agent does
tools:
  - Bash
  - Read
  - Edit
---

# Your Agent Name

Your agent's system prompt and instructions go here...

Contributing

To add more plugins to this marketplace:

1. Create a new plugin directory in plugins/
2. Add .claude-plugin/plugin.json with plugin metadata
3. Add agents, commands, hooks, or skills as needed
4. Update .claude-plugin/marketplace.json to include the new plugin
5. Test the plugin in your Claude Code environment
6. Submit a pull request

Publishing

See PUBLISHING.md for detailed instructions on publishing this marketplace.

Quick Start: GitHub Distribution (Recommended)

# Initialize and push to GitHub
git init
git add .
git commit -m "Initial commit: npm-test marketplace"
git remote add origin https://github.com/yourusername/marketplace-npm.git
git push -u origin main

# Tag a release
git tag -a v1.0.0 -m "Release v1.0.0"
git push origin v1.0.0

Users can then install with:

/plugin marketplace add yourusername/marketplace-npm
/plugin install npm-test@marketplace-npm-test

npm Publishing (Not Recommended)

While you can publish to npm, the npm source type for Claude Code marketplaces is not yet fully implemented. GitHub distribution is recommended instead.

If you still want to publish to npm:

npm login
npm publish

See PUBLISHING.md for complete details.

Learn More

• Create and distribute a plugin marketplace
• Create custom subagents
• Claude Agent SDK
• NPM Package: @anthropic-ai/claude-agent-sdk

License

MIT