Enterprise Skills Repository

Enterprise-wide AI skills catalog for AI-assisted and human development. This repository provides a versioned, canonical source of truth for reusable skills that extend AI agents (Codex, Copilot, Cursor, Junie, Claude, Roo, ChatGPT) with specialized knowledge, workflows, and tool integrations.

Repository Structure

AIRules/
|-- README.md              # repository overview and complete skill catalog
|-- skills.md              # categorized skills catalog and load order
|-- LICENSE
|-- scripts/               # repository authoring tools
`-- skills/
    |-- .curated/          # 39 general-purpose skills, including Azure access audits
    `-- .system/           # 78 ecosystem and tooling skills
        |-- activitymaster/
        |-- entityassist/
        |-- guicedee-*/    # 29 GuicedEE skills
        |-- jwebmp-*/      # 45 JWebMP skills, including website aside routing
        |-- skill-creator/
        `-- skill-installer/

Skill anatomy

Every skill is a self-contained folder with a required SKILL.md and optional bundled resources:

skill-name/
├── SKILL.md              (required — YAML frontmatter + Markdown instructions)
├── agents/               (recommended — UI metadata)
│   └── openai.yaml
├── references/           (optional — domain docs loaded on demand)
├── scripts/              (optional — executable automation)
└── assets/               (optional — icons, templates, etc.)

Enterprise Usage

Consuming as a Git submodule

git submodule add https://github.com/GuicedEE/ai-rules.git rules/
git submodule update --init --recursive

Host projects reference skills from the submodule. Do not place project-specific artifacts inside the submodule directory.

Installing individual skills (Codex / CLI)

Use the skill-installer skill to install skills into $CODEX_HOME/skills/:

# List available skills (curated from both OpenAI and GuicedEE sources)
python skills/.system/skill-installer/scripts/list-skills.py

# Install a curated skill by name
python skills/.system/skill-installer/scripts/install-skill-from-defaults.py senior-architect

# Install from any GitHub repo
python skills/.system/skill-installer/scripts/install-skill-from-github.py \
  --repo GuicedEE/ai-rules --path skills/.curated/figma

Creating new skills

Use the skill-creator skill for guided skill authoring:

# Bootstrap a new skill skeleton
python skills/.system/skill-creator/scripts/init_skill.py my-new-skill --path skills/.system

# Generate agents/openai.yaml metadata
python skills/.system/skill-creator/scripts/generate_openai_yaml.py skills/.system/my-new-skill

See skills/.system/skill-creator/SKILL.md for the full creation guide.

Validating the catalog

Run python -B -X utf8 scripts/validate-skills.py to check all skill frontmatters, existing UI metadata/assets, and local Markdown links and anchors. See skill catalog maintenance for the current OpenAI creator source, description-budget guidance, and global installation workflow.

Skill Catalogs

Curated Skills (.curated/)

General-purpose skills suitable for any project:

Skill	Description
aggrid	AG Grid MCP integration, column definitions, row models, version migrations
api-integration-specialist	API integration design and implementation
arm-to-terraform-migration	Azure ARM template → Terraform migration
azure-access-and-exposure-audit	Azure public exposure audits, RBAC/PIM access diagnosis, and PowerShell/bash audit tools
changelog-generator	Automated changelog generation from commits
code-reviewer	Structured code review with checklists and diff analysis
dispatching-parallel-agents	Parallel agent orchestration and dispatch patterns
figma	Figma MCP integration for design-to-code workflows
finishing-a-development-branch	Branch completion, cleanup, and merge workflows
gh-address-comments	GitHub PR comment resolution
gh-fix-ci	GitHub CI failure diagnosis and repair
git-commit-helper	Conventional commit message crafting
git-commit-signing	Configure and troubleshoot Git commit signing
information-architect	Information architecture and content strategy
playwright	Playwright end-to-end test authoring
screenshot	Screenshot capture and visual comparison
security-best-practices	Language/framework-specific security reviews and reports
security-compliance	Security compliance auditing
security-ownership-map	Security ownership mapping
senior-architect	System design, ADRs, trade-off analysis, architecture diagrams
senior-backend	Backend engineering workflows
senior-devops	DevOps and infrastructure workflows
senior-prompt-engineer	Prompt engineering and optimization
senior-qa	Quality assurance and test strategy
senior-secops	Security operations workflows
skill-adopter	Adopt and wire enterprise skills into a project for any AI agent
structured-skill-creator	Structured skill authoring guide
systematic-debugging	Systematic debugging methodology
terraform-code-generator	Terraform code generation
terraform-doc-generator	Terraform documentation generation
terraform-module-scaffold	Terraform module scaffolding
terraform-plan-analyzer	Terraform plan analysis
terraform-project-generator	Terraform project generation
terraform-resource-fetch	Terraform resource fetching
terraform-security-scanner	Terraform security scanning
terraform-state-manager	Terraform state management
terraform-validator	Terraform validation
test-driven-development	Red → green → refactor TDD workflow
using-git-worktrees	Git worktree workflows

System Skills (.system/)

Project-specific skills for the GuicedEE ecosystem:

Skill	Description
activitymaster	FSDM domain services, enterprise resource management, reactive persistence
entityassist	CRTP entities, fluent query builder, reactive CRUD with Mutiny
guicedee-auth	Authentication and authorization (OAuth2, JWT, ABAC, OTP, Property File, LDAP, htpasswd, htdigest)
guicedee-cdi	CDI integration
guicedee-cerial	Serial port connectivity with jSerialComm and Vert.x
guicedee-client	Runtime context, lifecycle SPI contracts, and environment configuration
guicedee-cloud-app	Multi-module cloud app scaffolding/audit (parent + BOM + service modules + observability stack)
guicedee-config	MicroProfile Config
guicedee-creator	GuicedEE project scaffolding and baseline verification
guicedee-hazelcast	Hazelcast clustering, Vert.x cluster manager, JCache, distributed data structures
guicedee-health	MicroProfile Health
guicedee-ibmmq	IBM MQ messaging (JMS 3.0, queues, topics, transacted sessions, durable subscriptions)
guicedee-inject	Guice DI with classpath scanning and lifecycle
guicedee-installer	Module installation and retrofit
guicedee-jpms-shade	Shade automatic-module JARs into JPMS service modules for the jlink pipeline
guicedee-jwt	MicroProfile JWT bridge, claim injection, and role-based access
guicedee-kafka	Kafka messaging
guicedee-mail-client	SMTP mail client
guicedee-metrics	MicroProfile Metrics
guicedee-openapi	OpenAPI/Swagger integration
guicedee-persistence	JPA/Hibernate persistence wiring
guicedee-rabbitmq	RabbitMQ messaging
guicedee-rest	JAX-RS REST endpoints
guicedee-rest-client	Typed REST clients using @Endpoint and Vert.x WebClient
guicedee-service-registry	Named service registry with health-aware URL resolution
guicedee-swagger-ui	Swagger UI serving
guicedee-telemetry	OpenTelemetry integration
guicedee-vertx	Vert.x 5 event-bus, verticles, reactive wiring
guicedee-web	Web module configuration
guicedee-webservices	SOAP/XML web services
guicedee-websockets	WebSocket integration
jwebmp-agcharts	AG Charts community integration
jwebmp-agcharts-enterprise	AG Charts enterprise visualization
jwebmp-aggrid	AG Grid community data tables
jwebmp-aggrid-enterprise	AG Grid enterprise data grids
jwebmp-angular	Angular framework integration
jwebmp-angular-forms	Angular reactive forms
jwebmp-angular-graphql	Apollo GraphQL client generation (@NgGraphQL)
jwebmp-angular-material	Angular Material design components
jwebmp-bootstrap	Bootstrap CSS framework
jwebmp-c3	C3 D3-based charting
jwebmp-chartjs	Chart.js charting
jwebmp-client	JWebMP client module
jwebmp-core	JWebMP core framework (HTML, CSS, events, page configurators)
jwebmp-d3	D3.js data visualization
jwebmp-datatables	DataTables advanced HTML tables
jwebmp-easing	jQuery easing animations
jwebmp-easy-pie-chart	Animated pie charts
jwebmp-fontawesome	Font Awesome free icons
jwebmp-fontawesome-pro	Font Awesome pro icons
jwebmp-fullcalendar	FullCalendar community
jwebmp-fullcalendar-pro	FullCalendar pro with advanced features
jwebmp-globalize	Internationalization (i18n)
jwebmp-glyph-icons	Glyph icons
jwebmp-jqplot	jqPlot jQuery charting
jwebmp-jquery	jQuery DOM manipulation library
jwebmp-jquery-ui	jQuery UI widgets and interactions
jwebmp-local-storage	Browser local storage persistence
jwebmp-markdown	Markdown parsing and rendering
jwebmp-material-design-icons	Google Material Design icons
jwebmp-material-icons	Google Material icons
jwebmp-plus-as-tab	Plus button tab navigation
jwebmp-prettify	Google Prettify code highlighting
jwebmp-prism	Prism syntax highlighting
jwebmp-session-storage	Browser session storage
jwebmp-skycons	Animated weather icons
jwebmp-themify-icons	Themify icon fonts
jwebmp-toastr	Toast notification alerts
jwebmp-tsclient	TypeScript client code generation
jwebmp-vertx	JWebMP Vert.x event bus runtime
jwebmp-waves-effect	Material Design ripple effects
jwebmp-waypoints	Scroll-triggered callbacks
jwebmp-weather-icons	Weather icon fonts
jwebmp-webawesome	Web Awesome community components
jwebmp-webawesome-pro	Web Awesome pro web components
jwebmp-website-aside-routing	WaPage named aside outlets, route synchronization, and empty-aside layout collapse
skill-creator	Creating and updating skills with proper anatomy
skill-installer	Installing skills from curated lists or GitHub repos

Refreshing from global skills

The 2026-09-12 refresh imports changes to 26 existing skills and adds azure-access-and-exposure-audit and jwebmp-website-aside-routing from the global ~/.agents/skills/ collection. The repository now contains 117 skills: 39 curated and 78 system. ActivityMaster lifecycle/resource guidance, GuicedEE runtime and REST contracts, EntityAssist session guidance, and WebAwesome component APIs are included in the refresh.

For subsequent updates, compare the global skill folders with this checkout by skill name. Keep existing tier assignments; put general-purpose additions in .curated/ and ecosystem-specific additions in .system/. Copy each changed skill with its references, scripts, assets, and agent metadata. Preserve repository-only skills, and exclude caches and generated output. Update both catalogs and validate frontmatter and local links. Run bundled script checks without invoking live cloud operations. Keep bash scripts as LF without a BOM, as specified by the Azure skill's .gitattributes.

Review incoming changes against corrections already maintained here; an older global installation must not overwrite newer repository fixes. The Azure skill includes offline regression tests for its scripts, documented in its SKILL.md.

The global installation is the input to this refresh; updating this checkout does not install skills into agent profiles or publish changes upstream.

Principles

🧭 Continuity

We carry context across threads. We remember conventions and tone. We pick up where we left off.

🧩 Finesse

We refine outputs iteratively. We respect nuance — less brute-forcing, more shaping. We preserve language, structure, and intent.

🌿 Collaborative Flow

This is not a question-answer transaction. It's a collaborative design conversation that grows over time.

🔁 Closing Loops

Every artifact links forward (to implementation) and backward (to its reasoning). We don't leave threads dangling.

Forward-Only Change Policy

• Apply requested changes in full: update/remove conflicting documents, indexes, and links in the same change.
• Do not leave stubs or partial updates; provide complete, final artifacts.
• Only maintain backwards compatibility if the request explicitly requires it.

Structure of Work

Layer	Description	Artifact
Skills	Modular, self-contained domain knowledge	skills/
References	Supporting docs loaded on demand	skills/**/references/
Scripts	Executable automation bundled with skills	skills/**/scripts/

Host project setup

• Skills — Install relevant skills via skill-installer or reference the submodule directly.
• Agent configs — Use skill-adopter to generate agent-native configuration files for your AI tools.
• Project docs — Place project-specific documentation outside the submodule (e.g., under docs/).

Docs-as-Code Diagrams Policy

All projects should maintain text-based architecture diagrams that are reviewable by humans and consumable by AI:

• C4 Architecture: L1 (Context), L2 (Container), L3 (Component). L4 optional.
• Sequence Diagrams: Critical flows including async boundaries.
• ERDs: Core domain models, relationships, bounded context ownership.
• Deployment/Runtime: Topology, environments, infrastructure.

Use Mermaid in fenced Markdown blocks. Commit diagram sources — images are optional derivatives.

Usage Tips

• Ask: "What skills are available?" to list discovered skills.
• Use skill-installer to browse and install skills interactively.
• Use skill-creator to author new skills following the standard anatomy.
• Each skill's SKILL.md frontmatter (name + description) determines when the skill triggers.
• Skill instructions (body) are loaded only after activation.

Notes

• Keep skills focused and concise — the context window is shared with everything else.
• Use lowercase-hyphen names for skill directories.
• Each skill must have valid YAML frontmatter with name and description.
• Prefer relative links within skills.