I-Synergy.Framework

Converts a technical book (PDF or EPUB) into a structured Claude Code skill — extracting frameworks, mental models, principles, techniques, and anti-patterns the author crystallized. Use when the user wants to study a book through Claude, apply an author's frameworks while working, or build a reusable knowledge base from any PDF or EPUB.

Update the accent colors in an I-Synergy Keycloak login theme from a single base hex color. Trigger when the user provides a hex color code (like "#0078D7") for a theme, says "align colors with the logo", "update the theme colors", "set the accent to

Syncs .claude/skills/ and .github/skills/ from .ai/skills/ (the source of truth). Run after adding, editing, or removing a skill in .ai/skills/.

Upgrades an existing project with improvements from the CLAUDE.MD template. Use when the user says "upgrade the template", "sync template changes to a project", "update project X with new skills", or wants to apply template improvements without losing project-specific context. Runs upgrade-template.py which copies new files and diffs changed ones, never touching project-owned paths.

Converts a technical book (PDF or EPUB) into a structured Claude Code skill — extracting frameworks, mental models, principles, techniques, and anti-patterns the author crystallized. Use when the user wants to study a book through Claude, apply an author's frameworks while working, or build a reusable knowledge base from any PDF or EPUB.

Update the accent colors in an I-Synergy Keycloak login theme from a single base hex color. Trigger when the user provides a hex color code (like "#0078D7") for a theme, says "align colors with the logo", "update the theme colors", "set the accent to

API security specialist. Use for securing APIs, implementing authentication/authorization, protecting against OWASP API Top 10, or handling security best practices.

Code quality and architecture review specialist. Use when reviewing code for SOLID principles, CQRS patterns, security issues, or architecture compliance before merging.

.NET/C#/Blazor/MAUI development expert. Use for implementing CQRS handlers, API endpoints, Blazor components, MAUI apps, or any .NET code development tasks.

Documentation specialist. Use when creating XML documentation, API docs, architecture diagrams, README files, or technical documentation.

Solution architecture and system design expert. Use when designing system architecture, choosing technology stacks, making architectural decisions, or defining bounded contexts.

Blazor UI development specialist. Use for building Blazor Server or WebAssembly apps, component development, state management, or form handling.

EF Core migrations and database specialist. Use when creating/applying database migrations, designing schemas, optimizing queries, or managing PostgreSQL databases.

Structured design interrogation — interview the user relentlessly about a plan, architecture, or technical decision until every branch of the decision tree is resolved. Use whenever a user says "grill me", "stress-test my plan", "poke holes in this", "challenge my design", "interview me about this design", or wants a rigorous review of any design, architecture, or technical proposal — even if they don't use these exact words. When in doubt, trigger this skill.

DevOps and CI/CD specialist. Use for building pipelines, containerization, infrastructure as code, or deployment automation. User-invocable only for production deployments.

Validates a generated or implemented solution against the original architecture document and design decisions. Run after solution-generator or after completing feature implementation to verify alignment. Trigger whenever the user says "gap review", "validate the implementation", "check against the design", or after solution generation completes. Identifies gaps, deviations, and missing decisions.

External API integration specialist. Use when integrating with third-party APIs, implementing webhooks, message queues, or handling external service communication.

MAUI mobile development specialist. Use for building cross-platform mobile apps, implementing offline-first architecture, platform-specific features, or data synchronization.

Performance optimization specialist. Use when profiling applications, optimizing database queries, implementing caching, or improving response times.

Playwright E2E and UI testing specialist. Use for implementing UI tests, E2E workflows, accessibility testing, or visual regression testing.

Bulk refactor specialist. Use for large-scale find-and-replace transformations, renaming patterns across the entire solution, or systematically migrating from one pattern to another. Trigger whenever the user says "rename X to Y everywhere", "change all X to Y", "migrate from X to Y", or needs to apply a transformation to many files at once — even if they don't use the word "refactor".

Security architect and coordinator. Use for overall security strategy, compliance requirements (GDPR, SOC2, HIPAA), threat modeling, or coordinating security across teams.

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit or optimize an existing skill, write test cases, or improve a skill's description for better triggering accuracy. Trigger whenever the user says "create a skill", "make a skill for X", "turn this into a skill", "improve this skill", or wants to capture a workflow as a reusable skill.

Application security specialist. Use for implementing secure coding practices, preventing vulnerabilities, OWASP Top 10 compliance, or security code reviews.

Generates a complete .NET solution scaffold from an architecture document and design interrogation deliverables. Use after running design-interrogation to translate the architecture document, ubiquitous language, and use cases into a working solution structure with all projects, CQRS handlers, and entity configurations. Trigger whenever the user says "generate the solution", "scaffold the project", "create the solution structure", or wants to turn an architecture document into code.

Captures and maintains the domain vocabulary (ubiquitous language) for a bounded context. Use when building a domain model, running a design interrogation session, or whenever domain terms need to be defined and documented. Trigger whenever the user says "define domain terms", "glossary", "ubiquitous language", or when terms emerge during design sessions. Outputs a structured glossary to UBIQUITOUS_LANGUAGE.md.

MSTest unit testing specialist. Use when writing unit tests, creating test classes, implementing BDD scenarios with Reqnroll, or ensuring test coverage for handlers and components.

Drafts and finalizes use case specifications for bounded contexts. Use when a bounded context's main flow becomes clear during design sessions, or to extract use cases from existing documents. Trigger whenever the user says "use case", "user flow", "system interaction", or asks to document what the system does. Outputs structured specifications with main flow, alternate flows, and Gherkin scenarios to docs/bounded-contexts/{BC}/use-cases.md.

Drafts and finalizes user stories with Gherkin acceptance criteria for bounded contexts. Use when acceptance criteria for a feature are agreed during design sessions, or to extract stories from existing documents. Trigger whenever the user says "user story", "as a user", "acceptance criteria", or asks to define what a feature needs to do. Validates stories against INVEST criteria. Outputs structured stories with Gherkin to docs/bounded-contexts/{BC}/user-stories.md.

Audits CLAUDE.md and .ai/ reference files against actual codebase patterns. Use to detect configuration drift and ensure documentation stays in sync with the codebase.

Translates use cases and user stories into vertical slice blueprint JSON for feature-by-feature implementation. Use after solution-generator to plan each feature as a self-contained vertical slice spanning all layers. Trigger whenever the user says "vertical slice", "feature blueprint", "implement feature by feature", or wants to break down user stories into implementable slices.

API security specialist. Use for securing APIs, implementing authentication/authorization, protecting against OWASP API Top 10, or handling security best practices.

Solution architecture and system design expert. Use when designing system architecture, choosing technology stacks, making architectural decisions, or defining bounded contexts.

Blazor UI development specialist. Use for building Blazor Server or WebAssembly apps, component development, state management, or form handling.

Code quality and architecture review specialist. Use when reviewing code for SOLID principles, CQRS patterns, security issues, or architecture compliance before merging.

EF Core migrations and database specialist. Use when creating/applying database migrations, designing schemas, optimizing queries, or managing PostgreSQL databases.

DevOps and CI/CD specialist. Use for building pipelines, containerization, infrastructure as code, or deployment automation. User-invocable only for production deployments.

.NET/C#/Blazor/MAUI development expert. Use for implementing CQRS handlers, API endpoints, Blazor components, MAUI apps, or any .NET code development tasks.

Validates a generated or implemented solution against the original architecture document and design decisions. Run after solution-generator or after completing feature implementation to verify alignment. Trigger whenever the user says "gap review", "validate the implementation", "check against the design", or after solution generation completes. Identifies gaps, deviations, and missing decisions.

External API integration specialist. Use when integrating with third-party APIs, implementing webhooks, message queues, or handling external service communication.