@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.
- package/README.md +29 -209
- package/SKILL.md +162 -160
- package/history/CONTEXT.md +15 -0
- package/index.js +8 -0
- package/package.json +38 -43
- package/registry/skill_bank.json +1038 -1167
- package/roles/backend_expert.md +23 -23
- package/roles/code_reviewer.md +28 -28
- package/roles/frontend_expert.md +30 -30
- package/roles/gpt5_core.md +34 -34
- package/roles/hinglish_native.md +30 -0
- package/roles/product_manager.md +24 -24
- package/roles/security_auditor.md +31 -22
- package/roles/subagent_orchestrator.md +26 -26
- package/roles/technical_writer.md +25 -25
- package/roles/ui_ux_designer.md +22 -22
- package/roles/wisdom_extractor.md +29 -29
- package/skills/ai_history_maintenance.md +46 -41
- package/skills/anthropic_documents.md +16 -16
- package/skills/antigravity_mastery.md +15 -15
- package/skills/azure_graph_integrator.md +12 -12
- package/skills/coderabbit_review.md +36 -0
- package/skills/composio_integrator.md +16 -16
- package/skills/github_automation.md +17 -17
- package/skills/hashicorp_terraform.md +16 -16
- package/skills/letta_agent_memory.md +15 -15
- package/skills/lifecycle/brainstorming.md +58 -24
- package/skills/lifecycle/review_protocol.md +36 -25
- package/skills/mcp_master.md +17 -17
- package/skills/memory_cycle.md +45 -0
- package/skills/openai_structured_outputs.md +12 -12
- package/skills/orchestration/external_skill_retrieval.md +46 -30
- package/skills/orchestration/parallel_agent_dispatcher.md +38 -32
- package/skills/orchestration/plan_architect.md +32 -22
- package/skills/orchestration/plan_executor.md +34 -20
- package/skills/playwright_testing.md +15 -15
- package/skills/progressive_disclosure.md +26 -26
- package/skills/prompt_reasoning_trees.md +12 -12
- package/skills/react_best_practices.md +16 -16
- package/skills/react_native_performance.md +16 -16
- package/skills/sanity_architecture.md +16 -16
- package/skills/stripe_integration.md +17 -17
- package/skills/supabase_architect.md +17 -17
- package/skills/systematic_debugging.md +34 -34
- package/skills/tdd_mastery.md +32 -32
- package/skills/vercel_cloudflare_deploy.md +17 -17
- package/skills/writing_skills.md +26 -26
- package/LICENSE +0 -21
- 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`
|
|
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
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
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
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
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
|
package/skills/mcp_master.md
CHANGED
|
@@ -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.
|
|
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.
|
|
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
|