Skip to content

Commit 5ad5169

Browse files
kepimecclaude
kepimec
and
claude
committed
v1.4.0: Project starters, documentation overhaul, flexibility pass, community infrastructure — launch-ready
Project Configuration Starters (NEW): - Ready-to-copy CLAUDE.md and settings.json for game projects - Engine-specific starters: Godot 4.6, Unity 6.3, UE 5.7 - Full skill routing tables, coding standards, commit conventions Documentation Overhaul: - README restructured: 30-second quick-start, decision tree, visual catalog - 3 end-to-end workflow examples (zero-to-prototype, sprint cycle, launch prep) - FAQ addressing common setup questions - CONTRIBUTING.md expanded with starter/doc contribution guides Flexibility Pass: - All 11 hooks rewritten: POSIX-compatible, no set -e, graceful failure - Multi-path source detection (src/, scripts/, Scripts/, Source/, Assets/Scripts/) - Engine-aware commit validation and gap detection - game-start now suggests engine-specific directory structures - New docs/directory-conventions.md mapping guide Community Infrastructure: - Issue templates: bug report, feature request, skill request - PR template for contributions - Code of Conduct (Contributor Covenant v2.1) - Security policy (skill-aware) - .gitignore expanded: Godot + Unity + UE + IDEs + OS (10 → 97 lines) - Awesome-list submission drafts prepared Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent e32a92f commit 5ad5169

37 files changed

Lines changed: 2641 additions & 472 deletions

‎.github/ISSUE_TEMPLATE/bug_report.md‎

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
name: Bug Report
3+
description: Report a skill that isn't working correctly
4+
title: "[Bug] "
5+
labels: ["bug"]
6+
---
7+
8+
## Skill Name
9+
10+
Which skill is affected?
11+
12+
- [ ] game-accessibility-specialist
13+
- [ ] game-art-director
14+
- [ ] game-audio-director
15+
- [ ] game-creative-director
16+
- [ ] game-designer
17+
- [ ] game-economy-designer
18+
- [ ] game-narrative-director
19+
- [ ] game-producer
20+
- [ ] game-qa-lead
21+
- [ ] game-technical-director
22+
- [ ] game-ux-designer
23+
- [ ] game-analytics-setup
24+
- [ ] game-balance-check
25+
- [ ] game-brainstorm
26+
- [ ] game-code-review
27+
- [ ] game-design-review
28+
- [ ] game-launch
29+
- [ ] game-localization-manager
30+
- [ ] game-market-research
31+
- [ ] game-playtest
32+
- [ ] game-postmortem
33+
- [ ] game-prototype
34+
- [ ] game-retrospective
35+
- [ ] game-reverse-document
36+
- [ ] game-scope-check
37+
- [ ] game-sprint-plan
38+
- [ ] game-start
39+
- [ ] game-team-orchestrator
40+
- [ ] game-godot-specialist
41+
- [ ] game-unity-specialist
42+
- [ ] game-unreal-specialist
43+
44+
## Environment
45+
46+
- **Claude Code version**: <!-- e.g., 1.0.12 -->
47+
- **OS**: <!-- e.g., macOS 14.2, Windows 11, Ubuntu 22.04 -->
48+
- **Game engine** (if applicable): <!-- e.g., Godot 4.3, Unity 2022 LTS, Unreal 5.4 -->
49+
50+
## Description
51+
52+
<!-- A clear and concise description of what the bug is. -->
53+
54+
## Steps to Reproduce
55+
56+
1. <!-- Install the skill / run the command -->
57+
2. <!-- Provide this prompt: "..." -->
58+
3. <!-- Observe the output -->
59+
60+
## Expected Behavior
61+
62+
<!-- What you expected to happen. -->
63+
64+
## Actual Behavior
65+
66+
<!-- What actually happened. Include any error messages or unexpected output. -->
67+
68+
## Additional Context
69+
70+
<!-- Add any other context about the problem here. Screenshots, logs, or related issues are helpful. -->

‎.github/ISSUE_TEMPLATE/feature_request.md‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
name: Feature Request
3+
description: Suggest an improvement to an existing skill
4+
title: "[Feature] "
5+
labels: ["enhancement"]
6+
---
7+
8+
## Which Skill?
9+
10+
<!-- Name the skill you want improved, or write "general" if it applies to the whole project. -->
11+
12+
## What Would You Like Improved?
13+
14+
<!-- A clear description of the improvement you're looking for. -->
15+
16+
## Why? (Use Case)
17+
18+
<!-- Describe the problem or workflow this improvement would address. What are you trying to accomplish that the current skill doesn't support well? -->
19+
20+
## Proposed Solution (Optional)
21+
22+
<!-- If you have an idea for how this could be implemented, describe it here. This is optional -- we welcome the problem statement on its own. -->

‎.github/ISSUE_TEMPLATE/skill_request.md‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
name: Skill Request
3+
description: Request a new game development skill
4+
title: "[Skill Request] "
5+
labels: ["skill-request"]
6+
---
7+
8+
## Skill Name
9+
10+
<!-- What would you call this skill? Follow the naming convention: game-[name] -->
11+
12+
## Category
13+
14+
- [ ] Agent (a specialized studio role, like a director or lead)
15+
- [ ] Workflow (a structured process for a common game dev task)
16+
- [ ] Engine Specialist (deep expertise for a specific game engine)
17+
18+
## What Problem Does It Solve?
19+
20+
<!-- Describe the game development challenge this skill would address. -->
21+
22+
## Who Is the Target User?
23+
24+
<!-- Who would use this skill? Solo devs, small teams, specific disciplines? -->
25+
26+
## How Does It Fit with Existing Skills?
27+
28+
<!-- How would this skill interact with or complement the current 31 skills? Would it be used before/after a specific workflow? Would it collaborate with certain agents? -->
29+
30+
## Example Use Case
31+
32+
<!-- Walk through a concrete scenario where a developer would invoke this skill and what output they would expect. -->

‎.github/PULL_REQUEST_TEMPLATE.md‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
## What Changed
2+
3+
<!-- Brief description of what this PR does -->
4+
5+
## Type
6+
7+
- [ ] New skill
8+
- [ ] Skill improvement
9+
- [ ] Bug fix
10+
- [ ] Documentation
11+
- [ ] Infrastructure/CI
12+
13+
## Checklist
14+
15+
- [ ] Follows AlterLab skill format (if skill change)
16+
- [ ] Meets minimum line count for category (agents: 200, workflows: 150, engine specialists: 200)
17+
- [ ] All frontmatter fields present (`argument-hint`, `allowed-tools`, etc.)
18+
- [ ] Tested with 3+ prompts in Claude Code
19+
- [ ] No secrets or personal data included
20+
- [ ] Commit messages follow convention (`feat:`, `improve:`, `fix:`, `docs:`, `chore:`)
21+
22+
## Related Issues
23+
24+
<!-- Link any related issues: Fixes #123 -->

‎.github/SUBMISSIONS.md‎

Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
# Awesome-List Submission Drafts
2+
3+
Reference file for submitting GameForge to curated skill lists once the repo is public.
4+
5+
---
6+
7+
## 1. travisvn/awesome-claude-skills
8+
9+
**URL:** https://github.com/travisvn/awesome-claude-skills
10+
**Category:** Game Development (may need to propose new category)
11+
**Note:** Auto-closes PRs from repos with <10 stars. Submit after reaching 10+ stars.
12+
13+
**Draft entry:**
14+
```markdown
15+
### Game Development
16+
- [AlterLab GameForge](https://github.com/AlterLab-IEU/AlterLab_GameForge) - 31 production-grade skills for indie game development — 11 studio agents, 17 workflow skills, 3 engine specialists (Godot, Unity, Unreal)
17+
```
18+
19+
---
20+
21+
## 2. VoltAgent/awesome-agent-skills
22+
23+
**URL:** https://github.com/VoltAgent/awesome-agent-skills
24+
**Category:** Creative / Game Development
25+
**Format:** Table row
26+
27+
**Draft entry:**
28+
```markdown
29+
| [AlterLab GameForge](https://github.com/AlterLab-IEU/AlterLab_GameForge) | 31 production-grade Claude AI skills for indie game development — studio agents, workflow skills, and engine specialists for Godot, Unity, and Unreal Engine | skill |
30+
```
31+
32+
---
33+
34+
## 3. ComposioHQ/awesome-claude-skills
35+
36+
**URL:** https://github.com/ComposioHQ/awesome-claude-skills
37+
**Category:** Specialized Skills
38+
39+
**Draft entry:**
40+
```markdown
41+
- **[AlterLab GameForge](https://github.com/AlterLab-IEU/AlterLab_GameForge)** — A comprehensive game development skill suite with 31 skills organized as studio agents (Creative Director, Producer, Game Designer, etc.), structured workflows (sprint planning, code review, playtesting, launch prep), and deep engine specialists for Godot 4, Unity 6, and Unreal Engine 5. Grounded in MDA Framework, Flow Theory, and Self-Determination Theory.
42+
```
43+
44+
---
45+
46+
## 4. BehiSecc/awesome-claude-skills
47+
48+
**URL:** https://github.com/BehiSecc/awesome-claude-skills
49+
**Category:** Development Tools / Game Development
50+
**Note:** Lower star threshold — good for initial submission.
51+
52+
**Draft entry:**
53+
```markdown
54+
- [AlterLab GameForge](https://github.com/AlterLab-IEU/AlterLab_GameForge) - 31 game dev skills for Claude Code: studio agents, dev workflows, and engine specialists for Godot/Unity/Unreal. From concept to launch.
55+
```
56+
57+
---
58+
59+
## 5. hesreallyhim/awesome-claude-code
60+
61+
**URL:** https://github.com/hesreallyhim/awesome-claude-code
62+
**Category:** Skills / Plugins
63+
64+
**Draft entry:**
65+
```markdown
66+
- [AlterLab GameForge](https://github.com/AlterLab-IEU/AlterLab_GameForge) - 31 production-grade game dev skills — studio agents, workflows, engine specialists
67+
```
68+
69+
---
70+
71+
## Submission Strategy
72+
73+
1. **Phase 1 (immediate after going public):** Submit to BehiSecc and hesreallyhim (lower star thresholds)
74+
2. **Phase 2 (after 10+ stars):** Submit to travisvn (auto-rejects <10 stars)
75+
3. **Phase 3 (after 25+ stars):** Submit to VoltAgent and ComposioHQ (higher quality bars)
76+
4. **Parallel:** Ensure SkillsMP.com auto-indexes us (requires 2+ stars and correct marketplace.json)
77+
78+
## Web Directory Listings
79+
80+
- **SkillsMP.com** — Auto-indexes from GitHub. Ensure marketplace.json is valid.
81+
- **skillsdirectory.com** — Manual submission form
82+
- **awesomeclaude.ai** — Auto-indexes from awesome lists
83+
- **awesomeskills.dev** — Auto-indexes from awesome lists
84+
85+
---
86+
87+
*This file is a reference for maintainers. It is not shipped to users.*

‎.gitignore‎

Lines changed: 92 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,97 @@
1-
*.log
1+
# === OS Files ===
22
.DS_Store
3+
.DS_Store?
4+
Thumbs.db
5+
Desktop.ini
6+
ehthumbs.db
7+
*.swp
8+
*.swo
9+
*~
10+
11+
# === IDE / Editor ===
12+
.vscode/
13+
.idea/
14+
*.sublime-project
15+
*.sublime-workspace
16+
*.code-workspace
17+
.project
18+
.classpath
19+
.settings/
20+
21+
# === Node.js ===
22+
node_modules/
23+
npm-debug.log*
24+
yarn-debug.log*
25+
yarn-error.log*
26+
pnpm-debug.log*
27+
28+
# === Environment ===
329
.env
430
.env.local
5-
.reference/
6-
.research/
7-
node_modules/
31+
.env.*.local
32+
33+
# === Logs ===
34+
*.log
35+
36+
# === GameForge Runtime ===
837
production/session-logs/
938
production/session-state/
39+
40+
# === Research & Reference (dev only) ===
41+
.research/
42+
.reference/
43+
44+
# === Godot Engine ===
45+
# Godot 4 import cache (regenerated on open)
46+
.godot/
47+
# Binary translation files
48+
*.translation
49+
# Mono build artifacts (Godot C#)
50+
.mono/
51+
# Export presets may contain passwords
52+
export_presets.cfg
53+
# Uncomment to ignore import files (some teams track these):
54+
# *.import
55+
56+
# === Unity Engine ===
57+
Library/
58+
Temp/
59+
Obj/
60+
Build/
61+
Builds/
62+
Logs/
63+
UserSettings/
64+
MemoryCaptures/
65+
*.csproj
66+
*.sln
67+
*.suo
68+
*.tmp
69+
*.user
70+
*.userprefs
71+
*.pidb
72+
*.booproj
73+
ExportedObj/
74+
*.svd
75+
*.pdb
76+
*.mdb
77+
*.opendb
78+
*.VC.db
79+
crashlytics-buildid.txt
80+
81+
# === Unreal Engine ===
82+
Binaries/
83+
DerivedDataCache/
84+
Intermediate/
85+
Saved/
86+
*.VC.db
87+
*.opensdf
88+
*.sdf
89+
90+
# === Build Outputs ===
91+
dist/
92+
out/
93+
*.exe
94+
*.app
95+
*.apk
96+
*.aab
97+
*.unitypackage

‎CODE_OF_CONDUCT.md‎

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# Contributor Covenant Code of Conduct
2+
3+
## Our Pledge
4+
5+
We as members, contributors, and leaders pledge to make participation in our
6+
community a harassment-free experience for everyone, regardless of age, body
7+
size, visible or invisible disability, ethnicity, sex characteristics, gender
8+
identity and expression, level of experience, education, socio-economic status,
9+
nationality, personal appearance, race, caste, color, religion, or sexual
10+
identity and orientation.
11+
12+
We pledge to act and interact in ways that contribute to an open, welcoming,
13+
diverse, inclusive, and healthy community.
14+
15+
## Our Standards
16+
17+
Examples of behavior that contributes to a positive environment:
18+
19+
- Using welcoming and inclusive language
20+
- Being respectful of differing viewpoints and experiences
21+
- Giving and gracefully accepting constructive feedback
22+
- Accepting responsibility and apologizing to those affected by our mistakes
23+
- Focusing on what is best for the community
24+
25+
Examples of unacceptable behavior:
26+
27+
- Trolling, insulting, or derogatory comments
28+
- Public or private harassment
29+
- Publishing others' private information without explicit permission
30+
- Other conduct which could reasonably be considered inappropriate in a
31+
professional setting
32+
33+
## Enforcement
34+
35+
Instances of abusive, harassing, or otherwise unacceptable behavior may be
36+
reported by opening an issue on this repository or contacting the maintainers.
37+
All complaints will be reviewed and investigated and will result in a response
38+
that is deemed necessary and appropriate to the circumstances.
39+
40+
## Attribution
41+
42+
This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/),
43+
version 2.1, available at
44+
[https://www.contributor-covenant.org/version/2/1/code_of_conduct/](https://www.contributor-covenant.org/version/2/1/code_of_conduct/).
45+
46+
---
47+
48+
*AlterLab GameForge — Built by [AlterLab Creative Technologies Laboratory](https://github.com/AlterLab-IEU)*

0 commit comments

Comments
 (0)