@harshitj183/ai-skills 2.2.7 → 2.2.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/README.md +29 -209
  2. package/SKILL.md +162 -160
  3. package/history/CONTEXT.md +15 -0
  4. package/index.js +8 -0
  5. package/package.json +38 -43
  6. package/registry/skill_bank.json +1038 -1167
  7. package/roles/backend_expert.md +23 -23
  8. package/roles/code_reviewer.md +28 -28
  9. package/roles/frontend_expert.md +30 -30
  10. package/roles/gpt5_core.md +34 -34
  11. package/roles/hinglish_native.md +30 -0
  12. package/roles/product_manager.md +24 -24
  13. package/roles/security_auditor.md +31 -22
  14. package/roles/subagent_orchestrator.md +26 -26
  15. package/roles/technical_writer.md +25 -25
  16. package/roles/ui_ux_designer.md +22 -22
  17. package/roles/wisdom_extractor.md +29 -29
  18. package/skills/ai_history_maintenance.md +46 -41
  19. package/skills/anthropic_documents.md +16 -16
  20. package/skills/antigravity_mastery.md +15 -15
  21. package/skills/azure_graph_integrator.md +12 -12
  22. package/skills/coderabbit_review.md +36 -0
  23. package/skills/composio_integrator.md +16 -16
  24. package/skills/github_automation.md +17 -17
  25. package/skills/hashicorp_terraform.md +16 -16
  26. package/skills/letta_agent_memory.md +15 -15
  27. package/skills/lifecycle/brainstorming.md +58 -24
  28. package/skills/lifecycle/review_protocol.md +36 -25
  29. package/skills/mcp_master.md +17 -17
  30. package/skills/memory_cycle.md +45 -0
  31. package/skills/openai_structured_outputs.md +12 -12
  32. package/skills/orchestration/external_skill_retrieval.md +46 -30
  33. package/skills/orchestration/parallel_agent_dispatcher.md +38 -32
  34. package/skills/orchestration/plan_architect.md +32 -22
  35. package/skills/orchestration/plan_executor.md +34 -20
  36. package/skills/playwright_testing.md +15 -15
  37. package/skills/progressive_disclosure.md +26 -26
  38. package/skills/prompt_reasoning_trees.md +12 -12
  39. package/skills/react_best_practices.md +16 -16
  40. package/skills/react_native_performance.md +16 -16
  41. package/skills/sanity_architecture.md +16 -16
  42. package/skills/stripe_integration.md +17 -17
  43. package/skills/supabase_architect.md +17 -17
  44. package/skills/systematic_debugging.md +34 -34
  45. package/skills/tdd_mastery.md +32 -32
  46. package/skills/vercel_cloudflare_deploy.md +17 -17
  47. package/skills/writing_skills.md +26 -26
  48. package/LICENSE +0 -21
  49. package/bin/cli.js +0 -345
@@ -1,41 +1,46 @@
1
- ---
2
- name: "🤖 AI History Maintenance Skill"
3
- description: "This skill provides mandatory instructions for AI agents working on the `@harshitj183/ai-skills` pro"
4
- ---
5
-
6
- # 🤖 AI History Maintenance Skill
7
-
8
- This skill provides mandatory instructions for AI agents working on the `@harshitj183/ai-skills` project to maintain project history and transparency.
9
-
10
- ---
11
-
12
- ## 🧐 Skill Summary
13
- Empowers AI agents to systematically document their actions, changes, and milestones within the project's dedicated `history/CONTEXT.md` system.
14
-
15
- ## 🛠️ Implementation Guide
16
-
17
- ### 1. Mandatory Updates
18
- After completing any major task (e.g., adding a new skill, fixing a bug, updating configurations), you **MUST** update the master context file:
19
- - **`history/CONTEXT.md`**: Append or update the relevant section with your AI name, date, and a bulleted list of tasks performed or changes made.
20
-
21
- ### 2. Format and Tone
22
- - Use professional, clear markdown.
23
- - Maintain structured sections (e.g., Activity Log, System Architecture, Current Status).
24
- - Include dates in `YYYY-MM-DD` or `Month DD, YYYY` format in the Activity Log section.
25
- - Always sign the update with `*Last updated by: AI Assistant (<Name>)*`.
26
-
27
- ### 3. Verification
28
- Before concluding any session, verify that:
29
- - The `history/CONTEXT.md` file accurately reflects the current state of the project.
30
- - No other scattered history files are created, maintaining the single-file context principle.
31
-
32
- ## 🌟 Best Practices
33
- - **Proactive Documentation**: If you see a gap in history, fill it immediately in `CONTEXT.md`.
34
- - **Continuous Logging**: Update logs incrementally during long-running tasks.
35
- - **Context Awareness**: Read the `CONTEXT.md` file at the start of any new session to understand previous work and milestones.
36
-
37
- ---
38
- *Signed: AI History Architect*
39
-
40
- ---
41
- ⚡ Smart AI Skills Library | v2.2.7 | Active
1
+ ---
2
+ name: "🤖 AI History Maintenance Skill"
3
+ description: "This skill provides mandatory instructions for AI agents working on the `@harshitj183/ai-skills` project to maintain history."
4
+ ---
5
+
6
+ # 🤖 AI History Maintenance Skill
7
+
8
+ This skill provides mandatory instructions for AI agents working on the `@harshitj183/ai-skills` project to maintain project history and transparency.
9
+
10
+ ---
11
+
12
+ ## 🧐 Skill Summary
13
+ Empowers AI agents to systematically document their actions, changes, and milestones within the project's dedicated `history/CONTEXT.md` system.
14
+
15
+ ## 🛠️ Implementation Guide
16
+
17
+ ### 1. Mandatory Updates
18
+ After completing any major task (e.g., adding a new skill, fixing a bug, updating configurations), you **MUST** update the master context file:
19
+ - **`history/CONTEXT.md`**: Append or update the relevant section with your AI name, date, and a bulleted list of tasks performed or changes made.
20
+
21
+ ### 2. Format and Tone
22
+ - Use professional, clear markdown.
23
+ - Maintain structured sections (e.g., Activity Log, System Architecture, Current Status).
24
+ - Include dates in `YYYY-MM-DD` or `Month DD, YYYY` format in the Activity Log section.
25
+ - Always sign the update with `*Last updated by: AI Assistant (<Name>)*`.
26
+
27
+ ### 3. Verification
28
+ Before concluding any session, verify that:
29
+ - The `history/CONTEXT.md` file accurately reflects the current state of the project.
30
+ - No other scattered history files are created, maintaining the single-file context principle.
31
+
32
+ ## 🌟 Best Practices
33
+ - **Proactive Documentation**: If you see a gap in history, fill it immediately in `CONTEXT.md`.
34
+ - **Continuous Logging**: Update logs incrementally during long-running tasks.
35
+ - **Context Awareness**: Read the `CONTEXT.md` file at the start of any new session to understand previous work and milestones.
36
+
37
+ ### 4. Data Sensitivity & Privacy (CRITICAL)
38
+ - **NO PII/Secrets**: Never write API keys, passwords, bearer tokens, or sensitive Personally Identifiable Information (PII) to `CONTEXT.md` or logs.
39
+ - **Abstract Logic**: Describe *what* you did (e.g., "Updated auth logic") rather than showing the literal credentials or private data.
40
+ - **Audit Logs**: If you accidentally log a secret, rotate it immediately and scrub the history files.
41
+
42
+ ---
43
+ *Signed: AI History Architect*
44
+
45
+ ---
46
+ ⚡ Smart AI Skills Library | v2.2.8 | Active
@@ -1,16 +1,16 @@
1
- ---
2
- name: "Anthropic Documents Expert"
3
- description: "Rules for parsing and extracting knowledge from DOCX, PDF, PPTX, and XLSX."
4
- ---
5
-
6
- # Precision Extraction
7
- 1. **XLSX Logic:** Always process wide spreadsheets by streaming rows instead of loading an entire massive matrix into context. Evaluate column data types stringently before outputting schemas.
8
- 2. **PPTX Analysis:** Do not hallucinate chart data. If parsing images or slides within a PPTX, declare explicitly standard structural points (Slide 1: Title, Slide 2: Bullet points).
9
- 3. **PDF OCR:** Treat raw PDF text extraction as potentially prone to bad spacing. Never match exact string comparisons across multi-line breaks. Use regex `/[\s\S]*/` matching cautiously.
10
-
11
- # Document Editing
12
- - When co-authoring or restructuring, maintain the exact tone of the input document explicitly unless specified to rewrite.
13
- - Return final edits as clean Markdown mapping strictly to Word Headers (H1, H2, H3).
14
-
15
- ---
16
- ⚡ Smart AI Skills Library | v2.2.6 | Active
1
+ ---
2
+ name: "Anthropic Documents Expert"
3
+ description: "Rules for parsing and extracting knowledge from DOCX, PDF, PPTX, and XLSX."
4
+ ---
5
+
6
+ # Precision Extraction
7
+ 1. **XLSX Logic:** Always process wide spreadsheets by streaming rows instead of loading an entire massive matrix into context. Evaluate column data types stringently before outputting schemas.
8
+ 2. **PPTX Analysis:** Do not hallucinate chart data. If parsing images or slides within a PPTX, declare explicitly standard structural points (Slide 1: Title, Slide 2: Bullet points).
9
+ 3. **PDF OCR:** Treat raw PDF text extraction as potentially prone to bad spacing. Never match exact string comparisons across multi-line breaks. Use regex `/[\s\S]*/` matching cautiously.
10
+
11
+ # Document Editing
12
+ - When co-authoring or restructuring, maintain the exact tone of the input document explicitly unless specified to rewrite.
13
+ - Return final edits as clean Markdown mapping strictly to Word Headers (H1, H2, H3).
14
+
15
+ ---
16
+ ⚡ Smart AI Skills Library | v2.2.8 | Active
@@ -1,15 +1,15 @@
1
- ---
2
- name: "Antigravity OS & Workflow Mastery"
3
- description: "Advanced interaction rules for CLI invocation, bash routing, and OS-level operations."
4
- ---
5
-
6
- # CLI Orchestration
7
- 1. **Parallel Tooling:** Maximize parallel CLI invocations using `run_command` concurrently across batch jobs if states don't mutually conflict.
8
- 2. **Terminal Scraping:** Never use raw `cat` for files larger than 1000 lines. Default to `grep_search` and `view_content_chunk` to prevent context explosion.
9
- 3. **Activation Scripts:** Handle agent overload gracefully in Windows/Linux by slicing stdout responses and avoiding infinite crash loops in stderr rendering.
10
-
11
- # Workflow Bundling
12
- - Construct workflows as strict YAML-frontmatter markdown files with `// turbo` tags to permit specific safe auto-execution loops for repetitive tasks.
13
-
14
- ---
15
- ⚡ Smart AI Skills Library | v2.2.6 | Active
1
+ ---
2
+ name: "Antigravity OS & Workflow Mastery"
3
+ description: "Advanced interaction rules for CLI invocation, bash routing, and OS-level operations."
4
+ ---
5
+
6
+ # CLI Orchestration
7
+ 1. **Parallel Tooling:** Maximize parallel CLI invocations using `run_command` concurrently across batch jobs if states don't mutually conflict.
8
+ 2. **Terminal Scraping:** Never use raw `cat` for files larger than 1000 lines. Default to `grep_search` and `view_content_chunk` to prevent context explosion.
9
+ 3. **Activation Scripts:** Handle agent overload gracefully in Windows/Linux by slicing stdout responses and avoiding infinite crash loops in stderr rendering.
10
+
11
+ # Workflow Bundling
12
+ - Construct workflows as strict YAML-frontmatter markdown files with `// turbo` tags to permit specific safe auto-execution loops for repetitive tasks.
13
+
14
+ ---
15
+ ⚡ Smart AI Skills Library | v2.2.8 | Active
@@ -1,12 +1,12 @@
1
- ---
2
- name: "Microsoft Graph & Azure Integrator"
3
- description: "Rules for Azure AD tokens, Graph API requests, and Enterprise app setup."
4
- ---
5
-
6
- # Graph API Best Practices
7
- 1. **Token Scopes:** Request explicit `Mail.ReadWrite`, `User.Read` only based on what the application specifically mutates. Never use `Directory.ReadWrite.All` carelessly.
8
- 2. **Pagination Enforcement:** Implement strictly `odata.nextLink` tracking when querying users or large resource collections.
9
- 3. **Batching:** Reduce network overhead by clustering up to 20 sub-requests via `/$batch` endpoints when orchestrating multi-user mutations.
10
-
11
- ---
12
- ⚡ Smart AI Skills Library | v2.2.6 | Active
1
+ ---
2
+ name: "Microsoft Graph & Azure Integrator"
3
+ description: "Rules for Azure AD tokens, Graph API requests, and Enterprise app setup."
4
+ ---
5
+
6
+ # Graph API Best Practices
7
+ 1. **Token Scopes:** Request explicit `Mail.ReadWrite`, `User.Read` only based on what the application specifically mutates. Never use `Directory.ReadWrite.All` carelessly.
8
+ 2. **Pagination Enforcement:** Implement strictly `odata.nextLink` tracking when querying users or large resource collections.
9
+ 3. **Batching:** Reduce network overhead by clustering up to 20 sub-requests via `/$batch` endpoints when orchestrating multi-user mutations.
10
+
11
+ ---
12
+ ⚡ Smart AI Skills Library | v2.2.8 | Active
@@ -0,0 +1,36 @@
1
+ ---
2
+ name: "CodeRabbit Reviewer"
3
+ description: "High-precision, strict code review agent focusing on architectural patterns, clean code (SOLID/DRY), and premium design integrity."
4
+ ---
5
+
6
+ # 1. Review Methodology
7
+ The CodeRabbit persona is **Proactive**, **Opinionated**, and **Technical**. It does skip surface-level linting to focus on deep logic.
8
+
9
+ - **PR Summary**: Automatically generate a "What," "Why," and "How" summary of changes.
10
+ - **Line-by-line Critique**: Provide specific, actionable code suggestions (not just complaints).
11
+ - **Security & Performance**: Audit for potential leaks, race conditions, or O(n) disasters.
12
+
13
+ # 2. Logic Flow
14
+ ```mermaid
15
+ graph TD
16
+ A[Start Review] --> B{Analyze Diff}
17
+ B --> C[Check Architectural Consistency]
18
+ B --> D[Identify Code Smells]
19
+ B --> E[Security/Auth Audit]
20
+ C & D & E --> F[Synthesize Review]
21
+ F --> G[Generate PR Summary]
22
+ G --> H[Inline Suggestions]
23
+ H --> I[Final 'Approve' or 'Request Changes']
24
+ ```
25
+
26
+ # 3. Constraints & Personas
27
+ - **Stricter than Humans**: If a loop can be a map, suggest it. If a variable is shadowed, flag it.
28
+ - **Design Awareness**: Specifically for frontend, flag any deviations from established CSS tokens or glassmorphism standards.
29
+ - **No Fluff**: No "Good job" without technical justification. Focus on refinement.
30
+
31
+ # 4. Trigger Commands
32
+ - `Review with CodeRabbit`: Triggers full audit.
33
+ - `CodeRabbit, check this logic`: Focuses on a specific block.
34
+
35
+ ---
36
+ ⚡ Smart AI Skills Library | v2.2.8 | Active
@@ -1,16 +1,16 @@
1
- ---
2
- name: "Composio App Orchestrator"
3
- description: "Rules for integrating Claude with 500+ apps using ComposioHQ."
4
- ---
5
-
6
- # Integration Guidelines
7
- 1. **Authentication Handling:** Never expose OAuth keys directly. Rely entirely on Composio's managed authentication gateway via the Composio Plugin.
8
- 2. **Entity Management:** Whenever triggering cross-platform actions (e.g., Salesforce to Jira), link requests using fixed Composio `entity_id` values.
9
- 3. **Action Triggers:** Do not guess the API schemas. Use Composio's SDK `composio.executeAction(Action.GITHUB_CREATE_ISSUE, { ... })` for strongly-typed integrations.
10
-
11
- # Security
12
- - Ensure strict least-privilege scoping when generating the Composio connection links.
13
- - Treat every response payload as untrusted and sanitize before feeding into downstream actions.
14
-
15
- ---
16
- ⚡ Smart AI Skills Library | v2.2.6 | Active
1
+ ---
2
+ name: "Composio App Orchestrator"
3
+ description: "Rules for integrating Claude with 500+ apps using ComposioHQ."
4
+ ---
5
+
6
+ # Integration Guidelines
7
+ 1. **Authentication Handling:** Never expose OAuth keys directly. Rely entirely on Composio's managed authentication gateway via the Composio Plugin.
8
+ 2. **Entity Management:** Whenever triggering cross-platform actions (e.g., Salesforce to Jira), link requests using fixed Composio `entity_id` values.
9
+ 3. **Action Triggers:** Do not guess the API schemas. Use Composio's SDK `composio.executeAction(Action.GITHUB_CREATE_ISSUE, { ... })` for strongly-typed integrations.
10
+
11
+ # Security
12
+ - Ensure strict least-privilege scoping when generating the Composio connection links.
13
+ - Treat every response payload as untrusted and sanitize before feeding into downstream actions.
14
+
15
+ ---
16
+ ⚡ Smart AI Skills Library | v2.2.8 | Active
@@ -1,17 +1,17 @@
1
- ---
2
- name: "GitHub Automation Expert"
3
- description: "Rules for branching, merging, rebasing, CI/CD Actions, and PR generation."
4
- ---
5
-
6
- # Git Workflow
7
- 1. **Commit Messages:** Follow Conventional Commits format exactly: `feat(scope): message` or `fix(scope): message`.
8
- 2. **Rebasing:** Prefer rebasing over merge commits to keep the history linear. Warn against rebasing public branches.
9
- 3. **Conflict Resolution:** Never just guess. Always evaluate `<<<<<<< HEAD` blocks contextually based on recent timeline logic.
10
-
11
- # GitHub Actions
12
- - Keep workflows DRY. Use reusable workflows or composite actions for repeating test steps.
13
- - Set explicit read/write permissions for `GITHUB_TOKEN`.
14
- - Optimize action caching mapping (e.g. `actions/cache` or `setup-node` caching).
15
-
16
- ---
17
- ⚡ Smart AI Skills Library | v2.2.6 | Active
1
+ ---
2
+ name: "GitHub Automation Expert"
3
+ description: "Rules for branching, merging, rebasing, CI/CD Actions, and PR generation."
4
+ ---
5
+
6
+ # Git Workflow
7
+ 1. **Commit Messages:** Follow Conventional Commits format exactly: `feat(scope): message` or `fix(scope): message`.
8
+ 2. **Rebasing:** Prefer rebasing over merge commits to keep the history linear. Warn against rebasing public branches.
9
+ 3. **Conflict Resolution:** Never just guess. Always evaluate `<<<<<<< HEAD` blocks contextually based on recent timeline logic.
10
+
11
+ # GitHub Actions
12
+ - Keep workflows DRY. Use reusable workflows or composite actions for repeating test steps.
13
+ - Set explicit read/write permissions for `GITHUB_TOKEN`.
14
+ - Optimize action caching mapping (e.g. `actions/cache` or `setup-node` caching).
15
+
16
+ ---
17
+ ⚡ Smart AI Skills Library | v2.2.8 | Active
@@ -1,16 +1,16 @@
1
- ---
2
- name: "HashiCorp Terraform Auto-Deployer"
3
- description: "HCL code generation and AWS/GCP Provider orchestration."
4
- ---
5
-
6
- # Terraform Module Generation
7
- 1. **State Isolation:** Never use a single unified `apply` for an entire company stack. Isolate state using Workspaces or entirely separate `prod/`, `staging/` directories.
8
- 2. **Data Variables:** Hardcode absolutely nothing. Use `variables.tf` heavily and separate environment tiers via `terraform.tfvars`.
9
- 3. **Provider Pinning:** Always pin provider versions inside the `required_providers` block block to prevent breaking API changes from propagating automatically.
10
-
11
- # Best Practices
12
- - Output strictly what is necessary (e.g., Load Balancer URLs) to prevent leaking exact subnet or SG configurations.
13
- - Default to `for_each` over `count` when looping to avoid shifting indices issues upon list modifications.
14
-
15
- ---
16
- ⚡ Smart AI Skills Library | v2.2.6 | Active
1
+ ---
2
+ name: "HashiCorp Terraform Auto-Deployer"
3
+ description: "HCL code generation and AWS/GCP Provider orchestration."
4
+ ---
5
+
6
+ # Terraform Module Generation
7
+ 1. **State Isolation:** Never use a single unified `apply` for an entire company stack. Isolate state using Workspaces or entirely separate `prod/`, `staging/` directories.
8
+ 2. **Data Variables:** Hardcode absolutely nothing. Use `variables.tf` heavily and separate environment tiers via `terraform.tfvars`.
9
+ 3. **Provider Pinning:** Always pin provider versions inside the `required_providers` block block to prevent breaking API changes from propagating automatically.
10
+
11
+ # Best Practices
12
+ - Output strictly what is necessary (e.g., Load Balancer URLs) to prevent leaking exact subnet or SG configurations.
13
+ - Default to `for_each` over `count` when looping to avoid shifting indices issues upon list modifications.
14
+
15
+ ---
16
+ ⚡ Smart AI Skills Library | v2.2.8 | Active
@@ -1,15 +1,15 @@
1
- ---
2
- name: "Letta Agent Memory Manager"
3
- description: "Rules for long-term memory management, persistent context, and core Letta-style memory blocks."
4
- ---
5
-
6
- # Core Memory Blocks
7
- 1. **Persona Update:** Agents must actively call `core_memory_append` to update their understanding of the user state or global variable states.
8
- 2. **Archival Memory:** Use archival search strategies for infinite-context scrolling. Avoid overloading context windows.
9
- 3. **Context Truncation Alert:** Always respond gracefully if `warning_context_limit` triggers by summarizing preceding events into the core memory block and continuing.
10
-
11
- # Best Practices
12
- - Agents run indefinitely. Maintain context continuity strictly via memory, never rely on conversation history alone.
13
-
14
- ---
15
- ⚡ Smart AI Skills Library | v2.2.6 | Active
1
+ ---
2
+ name: "Letta Agent Memory Manager"
3
+ description: "Rules for long-term memory management, persistent context, and core Letta-style memory blocks."
4
+ ---
5
+
6
+ # Core Memory Blocks
7
+ 1. **Persona Update:** Agents must actively call `core_memory_append` to update their understanding of the user state or global variable states.
8
+ 2. **Archival Memory:** Use archival search strategies for infinite-context scrolling. Avoid overloading context windows.
9
+ 3. **Context Truncation Alert:** Always respond gracefully if `warning_context_limit` triggers by summarizing preceding events into the core memory block and continuing.
10
+
11
+ # Best Practices
12
+ - Agents run indefinitely. Maintain context continuity strictly via memory, never rely on conversation history alone.
13
+
14
+ ---
15
+ ⚡ Smart AI Skills Library | v2.2.8 | Active
@@ -1,24 +1,58 @@
1
- ---
2
- name: "Idea-to-Spec Workflow"
3
- description: "High-fidelity brainstorming to transform raw user ideas into technical specifications."
4
- ---
5
-
6
- # 1. Brainstorming Logic
7
- When a user provides a raw idea or a vague request:
8
- - **Challenge Assumptions**: Ask "Why?" and "What is the core user pain point?".
9
- - **Constraint Identification**: List what is NOT being built.
10
- - **Architectural Mapping**: Determine which `roles/` and `skills/` from the library will be needed for this feature.
11
-
12
- # 2. Output: The Micro-Spec
13
- - **Goal**: One sentence.
14
- - **Features**: Bullet list of MUST-HAVEs.
15
- - **Edge Cases**: Identify 3-5 failure modes.
16
- - **Plan**: Hand-off to `skills/orchestration/plan_architect.md`.
17
-
18
- # 3. Collaborative Loop
19
- - Present the Micro-Spec to the user.
20
- - Incorporate one round of feedback.
21
- - Confirm final design before implementation.
22
-
23
- ---
24
- ⚡ Smart AI Skills Library | v2.2.6 | Active
1
+ ---
2
+ name: "Idea-to-Spec Workflow"
3
+ description: "High-fidelity brainstorming to transform raw user ideas into technical specifications."
4
+ ---
5
+
6
+ # 1. Ideation Flow
7
+
8
+ ```mermaid
9
+ graph LR;
10
+ A[Idea/Problem] --> B[Stakeholder Needs];
11
+ B --> C[Constraint Mapping];
12
+ C --> D[Solution Drafting];
13
+ D --> E[Feasibility Check];
14
+ E --> F[Core Spec];
15
+ ```
16
+
17
+ # 1. Protocol Logic
18
+ When a user provides a raw idea or a vague request:
19
+ - **Challenge Assumptions**: Ask "Why?" and "What is the core user pain point?".
20
+ - **Constraint Identification**: List what is NOT being built.
21
+ - **Architectural Mapping**: Determine which `roles/` and `skills/` from the library will be needed for this feature.
22
+
23
+ # 2. Review Protocol
24
+
25
+ ```mermaid
26
+ sequenceDiagram
27
+ participant U as User
28
+ participant AI as System
29
+ AI->>U: Present Micro-Spec
30
+ U->>AI: Provide Feedback
31
+ AI->>AI: Refine Spec
32
+ AI->>U: Confirm Final Design
33
+ ```
34
+
35
+ # 3. External Skill Retrieval
36
+
37
+ ```mermaid
38
+ graph TD;
39
+ A[Task Requirement] --> B{Skill Library};
40
+ B -->|Match Found| C[Load Skill Module];
41
+ B -->|No Match| D[Generate Custom Logic];
42
+ C --> E[Execute Task];
43
+ D --> E[Execute Task];
44
+ ```
45
+
46
+ # 4. Output: The Micro-Spec
47
+ - **Goal**: One sentence.
48
+ - **Features**: Bullet list of MUST-HAVEs.
49
+ - **Edge Cases**: Identify 3-5 failure modes.
50
+ - **Plan**: Hand-off to `skills/orchestration/plan_architect.md`.
51
+
52
+ # 3. Collaborative Loop
53
+ - Present the Micro-Spec to the user.
54
+ - Incorporate one round of feedback.
55
+ - Confirm final design before implementation.
56
+
57
+ ---
58
+ ⚡ Smart AI Skills Library | v2.2.8 | Active
@@ -1,25 +1,36 @@
1
- ---
2
- name: "Code Review Protocol"
3
- description: "High-fidelity feedback loops and rigorous quality assurance."
4
- ---
5
-
6
- # 1. Review Request Logic
7
- When requesting review (from a human or another AI):
8
- - **PR Summary**: List changed files and their logical impact.
9
- - **Critical Points**: Explicitly point out complex logic or sensitive changes.
10
- - **Context Pack**: Provide the `SKILL.md` rules and the current `status_summary.md` as context.
11
-
12
- # 2. Receiving Review Logic
13
- When processing feedback:
14
- 1. **Analyze**: Categorize by Impact (Critical, Minor, Nit).
15
- 2. **Respond**: Acknowledge each point and provide the reasoning behind the fix.
16
- 3. **Fix**: Use the `tdd_mastery.md` skill to safely implement any changes.
17
- 4. **Verify**: Run the full test suite again.
18
-
19
- # 3. Quality Metrics
20
- - Zero-defect code.
21
- - No regression.
22
- - Performance impact <1%.
23
-
24
- ---
25
- Smart AI Skills Library | v2.2.6 | Active
1
+ ---
2
+ name: "Code Review Protocol"
3
+ description: "High-fidelity feedback loops and rigorous quality assurance."
4
+ ---
5
+
6
+ # 1. Review Flow
7
+
8
+ ```mermaid
9
+ graph TD;
10
+ A[Output Draft] --> B[Self-Review];
11
+ B --> C[Logic Check];
12
+ C --> D[Security Audit];
13
+ D --> E[Persona Consistency];
14
+ E --> F[Final Submission];
15
+ ```
16
+
17
+ # 1. Review Request Logic
18
+ When requesting review (from a human or another AI):
19
+ - **PR Summary**: List changed files and their logical impact.
20
+ - **Critical Points**: Explicitly point out complex logic or sensitive changes.
21
+ - **Context Pack**: Provide the `SKILL.md` rules and the current `status_summary.md` as context.
22
+
23
+ # 2. Receiving Review Logic
24
+ When processing feedback:
25
+ 1. **Analyze**: Categorize by Impact (Critical, Minor, Nit).
26
+ 2. **Respond**: Acknowledge each point and provide the reasoning behind the fix.
27
+ 3. **Fix**: Use the `tdd_mastery.md` skill to safely implement any changes.
28
+ 4. **Verify**: Run the full test suite again.
29
+
30
+ # 3. Quality Metrics
31
+ - Zero-defect code.
32
+ - No regression.
33
+ - Performance impact <1%.
34
+
35
+ ---
36
+ ⚡ Smart AI Skills Library | v2.2.8 | Active
@@ -1,17 +1,17 @@
1
- ---
2
- name: "MCP Master Guidelines"
3
- description: "Rules for building Model Context Protocol (MCP) servers and tools."
4
- ---
5
-
6
- # MCP Architecture
7
- 1. **Server Instantiation:** Always use `@modelcontextprotocol/sdk/server/index.js` and `StdioServerTransport`.
8
- 2. **Schema Definition:** Define strictly typed input schemas using `zod` and map them to `ListToolsRequestSchema`.
9
- 3. **Execution Handling:** Map each named tool to its logic block inside `CallToolRequestSchema`. Parse inputs rigorously.
10
-
11
- # Core Principles
12
- - Treat MCP tools as pure functions; inputs go in, localized results come out. No global state side-effects.
13
- - Provide comprehensive error handling. Never crash the stdio transport.
14
- - Return responses strictly in the format `[{ type: "text", text: resultString }]`.
15
-
16
- ---
17
- ⚡ Smart AI Skills Library | v2.2.6 | Active
1
+ ---
2
+ name: "MCP Master Guidelines"
3
+ description: "Rules for building Model Context Protocol (MCP) servers and tools."
4
+ ---
5
+
6
+ # MCP Architecture
7
+ 1. **Server Instantiation:** Always use `@modelcontextprotocol/sdk/server/index.js` and `StdioServerTransport`.
8
+ 2. **Schema Definition:** Define strictly typed input schemas using `zod` and map them to `ListToolsRequestSchema`.
9
+ 3. **Execution Handling:** Map each named tool to its logic block inside `CallToolRequestSchema`. Parse inputs rigorously.
10
+
11
+ # Core Principles
12
+ - Treat MCP tools as pure functions; inputs go in, localized results come out. No global state side-effects.
13
+ - Provide comprehensive error handling. Never crash the stdio transport.
14
+ - Return responses strictly in the format `[{ type: "text", text: resultString }]`.
15
+
16
+ ---
17
+ ⚡ Smart AI Skills Library | v2.2.8 | Active
@@ -0,0 +1,45 @@
1
+ ---
2
+ name: "Memory Cycle"
3
+ description: "Archiving learned patterns and workflow insights from transient context into persistent history."
4
+ ---
5
+
6
+ # 1. Memory Workflow
7
+
8
+ ```mermaid
9
+ graph LR;
10
+ A[Session End] --> B[Extract Patterns];
11
+ B --> C[Evaluate Utility];
12
+ C -- High --> D[Archive to history/];
13
+ C -- Low --> E[Discard];
14
+ D --> F[Index Update];
15
+ ```
16
+
17
+ # 1. Trigger Condition
18
+ Activate this skill when:
19
+ - A complex task is completed (e.g., successful bug fix after multiple attempts).
20
+ - A new "Best Practice" or "Gotcha" is discovered for a specific technology.
21
+ - The user expresses a strong preference for a specific style or logic pattern.
22
+
23
+ # 2. Archival Protocol
24
+ 1. **Identify the Core**: Extract the specific logic or pattern that worked.
25
+ 2. **Standardize**: format the insight as a "Lesson Learned".
26
+ 3. **Persist**:
27
+ - Append to `history/lessons.md` OR create a new file in `history/patterns/`.
28
+ - Update `history/ai_activity_log.md` with the archival event.
29
+ 4. **Cleanup**: Clear the transient session memory of redundant details while keeping the "Pointer" to the archived history.
30
+
31
+ # 3. Lesson format
32
+ ```markdown
33
+ ## [Tech/Skill] - [Title]
34
+ - **Date**: YYYY-MM-DD
35
+ - **Context**: Problem description.
36
+ - **Solution**: The specific pattern that worked.
37
+ - **Why**: Rationale for why this is the preferred approach.
38
+ ```
39
+
40
+ # 4. Success Criteria
41
+ - Future sessions can refer to `history/` to avoid repeating errors.
42
+ - The library "grows" smarter with every interaction.
43
+
44
+ ---
45
+ ⚡ Smart AI Skills Library | v2.2.8 | Active
@@ -1,12 +1,12 @@
1
- ---
2
- name: "OpenAI Structured Outputs Expert"
3
- description: "Rules for extreme JSON schema strictness and function calling optimizations."
4
- ---
5
-
6
- # Function Calling Optimization
7
- 1. **JSON Schema Strictness:** Enforce `strict: true` validation on all `response_format` JSON Schema definitions. Do not use generic `object` types without defined explicit properties.
8
- 2. **Hallucination Prevention:** When returning enum arrays, reject all outputs not exactly mapping to the predefined subset.
9
- 3. **System Prompt Alignment:** Embed function definitions within the system instruction block rather than heavily relying on implicit user prompts to guess shapes.
10
-
11
- ---
12
- ⚡ Smart AI Skills Library | v2.2.6 | Active
1
+ ---
2
+ name: "OpenAI Structured Outputs Expert"
3
+ description: "Rules for extreme JSON schema strictness and function calling optimizations."
4
+ ---
5
+
6
+ # Function Calling Optimization
7
+ 1. **JSON Schema Strictness:** Enforce `strict: true` validation on all `response_format` JSON Schema definitions. Do not use generic `object` types without defined explicit properties.
8
+ 2. **Hallucination Prevention:** When returning enum arrays, reject all outputs not exactly mapping to the predefined subset.
9
+ 3. **System Prompt Alignment:** Embed function definitions within the system instruction block rather than heavily relying on implicit user prompts to guess shapes.
10
+
11
+ ---
12
+ ⚡ Smart AI Skills Library | v2.2.8 | Active