churchcrm
Skill998 starsChanged yesterdayMITView on GitHub
ChurchCRM project-specific development skills covering architecture, API, database, frontend, security, plugins, testing, and workflows. Use when working on any ChurchCRM feature, bug fix, or migration.
In this repository10 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- source-command-church-reviewSkill
- source-command-pr-reviewSkill
- source-command-prune-branchesSkill
- source-command-push-prSkill
- source-command-repo-healthSkill
- source-command-security-advisorySkill
- source-command-security-report-triageSkill
The file
Files
ChurchCRM Development Skills
These files apply to every agent family. Product floor is PHP 8.4+. Community plugins ship in the product. The plugin registry URL is CentralServices::PLUGIN_REGISTRY_URL.
Load skill-architecture.md only when adding or editing a skill.
Architecture & API
- Routing & Architecture
- Slim 4 Best Practices
- API Development
- Service Layer
| Skill | When to Use |
| Slim MVC Skill | Slim apps under src/ |
| Configuration Management | SystemConfig |
| Settings Placement | Where a setting lives, area admin hub |
| Volunteer Management v2 | Ministries / Volunteer v2 (full design: docs/design/volunteer-v2.md) |
| Member Portal Design | /portal and themes (flow, screens, data: docs/design/member-portal.md) |
Reports
| Skill | When to Use |
| Reports | PDF/CSV reports, mPDF, letterhead, statement downloads |
Database
| Skill | When to Use |
| Database Operations | ORM |
| DB Schema Migration | Schema / upgrade scripts |
Frontend & UI
Row actions: table-action-menu.md. Settings UI: copy the Finance dashboard pattern (frontend-development.md).
| Skill | When to Use |
| Icon Management | Font Awesome |
| Table Action Menu | Table row actions |
| Frontend Development | UI changes |
| Timezone Handling | Event / kiosk time |
| Responsive Design Guidelines | Layout |
| Webpack & TypeScript | Bundling |
| i18n & Localization | Wrap UI strings |
| Locale Translation | Translation agents |
| Currency Localization | Money display |
| Error Reporting & Issue Filing | Error pages |
Security
| Skill | When to Use |
| Authorization & Security | Roles / EditSelf |
| Security Best Practices | Escaping / CSRF |
| Security Advisory Review | GHSA |
| GitHub Interaction | Advisory publish |
Plugins
| Skill | When to Use |
| Plugin System | Runtime + registry constant |
| Plugin Registry | approved-plugins.json |
| Plugin Development | Author a plugin |
| Plugin Create (Community) | Submit a plugin |
| Plugin Migration | Update src/plugins/core/* when core APIs change |
| Plugin Security Scan | Intake |
| Plugin Compliance | Installed-plugin audit |
Testing
| Skill | When to Use |
| Cypress Testing | Writing and running specs, permission (gate) tests |
| CI & Test Infrastructure | PHP/Nette test packages, test stack, red CI, shards, test database and seed, cleanup guard |
| Marketing Visual-Media Pipeline | Playwright captures |
MVC / PHP
| Skill | When to Use |
| Admin MVC Migration | Convert a page to Slim MVC |
| Groups MVC Guidelines | Groups |
| Refactor | Feature refactor |
| PHP Best Practices | PHP / Perpl |
| Performance Optimization | Queries |
Community feedback policy (Feature Proposals and RFC Reviews Discussions): docs/decisions/0003-rfc-community-prioritization.md.
Process
| Skill | When to Use |
| Git Workflow | Commit / push |
| Release Management | Release preparation and verification |
| Maintainer Review Gates | Review a PR |
| PR Review | Standards checklist |
| Church Review | Review an issue from the church user's workflow |
| Stale Issue Triage | Re-triage stale-closed issues |
| Dependabot PR Review | /dependabot-review <PR>: npm or Composer upgrade review |
| PR Review Fix | Address review comments |
| Skill architecture | Edit a skill |
| PR Description Guidelines | Title / body |
| Development Workflows | Local setup commands |
| Code Standards | Always-on floor |
Example Workflows
- Review a PR:
maintainer-review-gates.md→pr-review.md. Draft only. - Church-review an issue:
church-review.md. Draft only. - Address PR comments:
../pr-review-fix.md→git-workflow.md - Add UI text:
i18n-localization.md.locale:buildruns on merge tomaster.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

