NeoForge Dev Skill

NeoForge 1.21.1 mod development skill suite for AI assistants, providing development workflow orchestration, code standards, quality guidelines, debugging guides, and release process management.

Overview

This skill suite provides comprehensive guidance for NeoForge 1.21.1 mod development:

• 🔄 Development Workflow - Complete process orchestration
• 📝 Code Standards - Naming conventions and best practices
• ✅ Quality Assurance - Code review and quality checks
• 🔧 Debugging Guides - Troubleshooting and diagnostics
• 🚀 Release Process - Build and publish workflow

Skill vs MCP Responsibilities

This repository works together with neoforge-dev-1.21.1-mcp:

Aspect	MCP Repository	Skill (This Repo)
Code Examples	✅ Real-time from docs	❌
MDK Templates	✅ Structured templates	❌
Documentation	✅ Searchable index	❌
Development Workflow	❌	✅ Process orchestration
Code Standards	❌	✅ Style guides & best practices
Debugging Guides	❌	✅ Troubleshooting & diagnostics
Release Workflow	❌	✅ Build & publish process

When to Use Which?

• Use MCP when you need: code examples, API docs, templates, migration patterns
• Use Skill when you need: workflow guidance, code review, debugging, release process

Repository Structure

neoforge-dev-1.21.1-skill/
├── neoforge-dev/                    # Main skill entry
│   ├── SKILL.md                     # Entry file
│   ├── README.md                    # Skill documentation
│   ├── settings.local.json          # Permission config
│   └── examples/                    # Standards & workflow docs
│       ├── code-style.md            # Code standards
│       ├── troubleshooting.md       # Troubleshooting guide
│       ├── testing.md               # Testing guide
│       ├── project-init.md          # Project initialization
│       ├── resources.md             # Resource files
│       ├── build-release.md         # Release process
│       └── migration.md             # Migration notes
├── dependencies/                    # All dependency skills
│   ├── NeoForge开发流程师/          # NeoForge - workflow orchestration
│   ├── NeoForge代码师/              # NeoForge - pattern reference
│   ├── NeoForge质量师/              # NeoForge - quality standards
│   ├── NeoForge调试师/              # NeoForge - debugging guide
│   ├── NeoForge发布师/              # NeoForge - release process
│   ├── 需求咨询师/                  # General - requirements analysis
│   ├── 创意策划师/                  # General - creative design
│   ├── 计划策划师/                  # General - planning
│   ├── 代理开发师/                  # General - plan execution
│   ├── 测试开发师/                  # General - TDD workflow
│   ├── 审查请求师/                  # General - code review request
│   ├── 审查接收师/                  # General - review feedback
│   ├── 完成验证师/                  # General - completion verification
│   ├── 问题诊断师/                  # General - problem diagnosis
│   └── 分支完成师/                  # General - branch completion
└── README.md                        # This file

Installation

Quick Install (OpenCode)

# Clone repository
git clone https://github.com/3453890470/neoforge-dev-1.21.1-skill.git

# Copy main skill
Copy-Item -Recurse neoforge-dev-1.21.1-skill/neoforge-dev "$env:USERPROFILE/.config/opencode/skills/"

# Copy all dependency skills
Copy-Item -Recurse neoforge-dev-1.21.1-skill/dependencies/* "$env:USERPROFILE/.config/opencode/skills/"

# Restart OpenCode

Manual Installation

1. Clone this repository
2. Copy skill directories to your OpenCode skills folder:
   • ~/.config/opencode/skills/ (Linux/macOS)
   • %USERPROFILE%\.config\opencode\skills\ (Windows)
3. Restart OpenCode

Usage

Trigger Keywords

The skill activates when your message contains:

• neoforge, neo forge, neoforged
• mod开发, 模组开发, 开发mod, 做mod, 写mod
• 物品, 方块, 实体, 配方, worldgen
• forge迁移, forge to neoforge
• 1.21.1, 1.21

Example Conversation

User: 我想做一个添加红宝石矿石的 NeoForge mod

AI: [自动加载 NeoForge开发流程师]
    我会帮你完成这个 mod 开发...
    [需要代码时调用 MCP get_neoforge_example]

Skill List

Skill	Purpose
neoforge-dev	Main entry, coordinates all sub-skills
NeoForge开发流程师	Main orchestrator, manages complete development workflow
NeoForge代码师	Core pattern reference, detailed examples via MCP
NeoForge质量师	Code standards and quality checks
NeoForge调试师	Problem diagnosis and troubleshooting
NeoForge发布师	Build and release process

General Skills (Dependencies)

Skill	Purpose
需求咨询师	Requirements analysis
创意策划师	Creative design
计划策划师	Implementation planning
代理开发师	Plan execution (agent-driven)
测试开发师	TDD test-driven development
审查请求师	Code review request
审查接收师	Review feedback handling
完成验证师	Pre-completion verification
问题诊断师	Systematic debugging
分支完成师	Branch completion and merge

Version Matrix

Component	Version
Minecraft	1.21.1
NeoForge	21.1.x
Java	21+
Node.js	18+
OpenCode	Latest

Integration

Required MCP Server

Configure the companion MCP server:

{
  "mcpServers": {
    "neoforge-mcp": {
      "command": "npx",
      "args": ["-y", "@3453890470/neoforge-dev"]
    }
  }
}

Recommended MCP

For Minecraft source code and Mixin analysis:

{
  "mcpServers": {
    "minecraft-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@mcdxai/minecraft-dev-mcp"]
    }
  }
}

OpenCode Configuration

{
  "skills": {
    "paths": ["~/.config/opencode/skills"]
  }
}

Claude Desktop

{
  "mcpServers": {
    "neoforge-mcp": {
      "command": "npx",
      "args": ["-y", "@3453890470/neoforge-dev"]
    }
  },
  "skills": {
    "paths": ["~/.config/opencode/skills"]
  }
}

Cursor IDE

{
  "mcp": {
    "servers": {
      "neoforge-mcp": {
        "command": "npx",
        "args": ["-y", "@3453890470/neoforge-dev"]
      }
    }
  },
  "skills": {
    "paths": ["~/.config/opencode/skills"]
  }
}

Zed Editor

{
  "assistant": {
    "default_model": {
      "provider": "anthropic",
      "model": "claude-3-5-sonnet"
    },
    "mcp_servers": {
      "neoforge-mcp": {
        "command": "npx",
        "args": ["-y", "@3453890470/neoforge-dev"]
      }
    }
  }
}

License

MIT License - see LICENSE for details.

Related Projects

• neoforge-dev-1.21.1-mcp - Code examples MCP
• forge-dev-1.20.1-mcp - Forge 1.20.1 MCP
• forge-dev-1.20.1-skill - Forge 1.20.1 skill