Back to Skills

init

verified

Configure project with MCPs, rules, and agents in one command

View on GitHub

Marketplace

potenlab-marketplace

potenlab/marketplace-potenlab

Plugin

pl

Repository

potenlab/marketplace-potenlab

skills/init/SKILL.md

Last Verified

January 25, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/potenlab/marketplace-potenlab/blob/main/skills/init/SKILL.md -a claude-code --skill init

Installation paths:

Claude
.claude/skills/init/
Powered by add-skill CLI

Instructions

# Project Initialization

Initialize a project with the Potenlab team's standard Claude Code configuration.

## What This Does

When you run `/pl:init`, Claude will:

1. **Check for .mcp.json**
   - If missing, create a placeholder configuration file
   - If exists, report current MCP configuration

2. **Check for .claude/rules/**
   - If missing, create the directory with placeholder rules
   - If exists, report existing rules

3. **Report Configuration**
   - Display what was created or found
   - Suggest next steps

## Instructions for Claude

When the user runs this command, perform the following steps:

### Step 1: Check MCP Configuration

```bash
if [ ! -f .mcp.json ]; then
  echo "Creating .mcp.json placeholder..."
  # Create placeholder - full MCP config comes in later phases
fi
```

If `.mcp.json` does not exist, create it with this placeholder content:

```json
{
  "mcpServers": {}
}
```

### Step 2: Check Rules Directory

```bash
if [ ! -d .claude/rules ]; then
  mkdir -p .claude/rules
  echo "Created .claude/rules/ directory"
fi
```

If `.claude/rules/` does not exist, create it and add a placeholder file:

**.claude/rules/README.md**
```markdown
# Claude Rules

Add project-specific rules here.

Rules are loaded by Claude Code to customize behavior for this project.
```

### Step 3: Report Results

After running, provide a summary:

```
Potenlab Project Initialization Complete!

Configuration:
- .mcp.json: [created/exists]
- .claude/rules/: [created/exists]

Next steps:
- Run /pl:help to see available commands
- Configure MCPs in .mcp.json as needed
- Add project rules to .claude/rules/
```

### Step 4: Display MCP Guidelines

After initialization, also display the MCP token budget guidelines:

```
MCP Token Budget Guidelines
---------------------------
- MCP tools should not exceed 40% of context
- Check usage with: /context or /pl:context
- Enable early Tool Search: ENABLE_TOOL_SEARCH=auto:5

Recommended MCP Configuration:
1. Use CLI tools (gh, aws, gc

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
2579 chars