Skip to content

Repository files navigation

Modrinth Project Growth

CI License: MIT Python 3.10+

A provider-neutral AI skill for turning real Modrinth project data into clearer pages, stronger releases, and measurable growth plans.

Works with mods, plugins, modpacks, resource packs, shaders, and datapacks. The skill is designed to run in any AI agent and does not require a specific vendor, API, browser, or runtime.

What it helps with

  • Audit and rewrite Modrinth project pages.
  • Analyze CSV and JSON statistics with safe conversion-rate calculations.
  • Build practical 7-, 30-, and 90-day roadmaps.
  • Prepare release notes and promotion copy for Modrinth, CurseForge, GitHub, Discord, Reddit, and video platforms.
  • Compare and prioritize a portfolio of projects.
  • Create branding briefs, competitor comparisons, and weekly growth reviews.

Install

Copy the modrinth-project-growth/ directory into your AI agent's skills directory. If the agent has no skill system, provide SKILL.md as system or developer context.

The skill remains useful without network access. Attach only the reference file needed for the current task, and provide project facts as YAML, JSON, CSV, Markdown, a URL, or a screenshot.

See the provider-neutral integration guide for examples.

Example requests

Audit https://modrinth.com/plugin/worldaccessblocker and give me the three highest-impact fixes.
Analyze stats.csv, calculate conversion rates, identify the strongest project, and create a one-week action plan.
Prepare a release for version 1.4.0 from these changes, including Modrinth, GitHub, Discord, and a short video script.

Local statistics tool

The optional statistics script uses only the Python standard library. It handles missing values, avoids division by zero, and never sends input to an external service.

python modrinth-project-growth/scripts/analyze_stats.py stats.csv
python modrinth-project-growth/scripts/analyze_stats.py stats.json --format json

Repository map

Path Purpose
modrinth-project-growth/SKILL.md Core skill contract and workflows
references/ Focused templates and decision guidance
assets/ Input templates
scripts/ Optional local utilities
examples/ Grounded example inputs and outputs
tests/ Automated checks for the statistics tool

Evidence-first by design

The skill separates facts, calculations, and hypotheses; asks for missing evidence; avoids spam and manipulation; and never promises rankings or guaranteed growth. Read the security policy and contribution guide before changing it.

Development

python -m unittest discover -s tests -v
python -m py_compile modrinth-project-growth/scripts/analyze_stats.py

Changelog

See CHANGELOG.md.

License

MIT — see LICENSE.

About

Provider-neutral AI skill for Modrinth project pages, statistics, releases, and measurable growth plans

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages