@techwavedev/agi-agent-kit 1.1.7 → 1.2.1

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.

Potentially problematic release.


This version of @techwavedev/agi-agent-kit might be problematic. Click here for more details.

Files changed (111) hide show
  1. package/CHANGELOG.md +82 -1
  2. package/README.md +190 -12
  3. package/bin/init.js +30 -2
  4. package/package.json +6 -3
  5. package/templates/base/AGENTS.md +54 -23
  6. package/templates/base/README.md +325 -0
  7. package/templates/base/directives/memory_integration.md +95 -0
  8. package/templates/base/execution/memory_manager.py +309 -0
  9. package/templates/base/execution/session_boot.py +218 -0
  10. package/templates/base/execution/session_init.py +320 -0
  11. package/templates/base/skill-creator/SKILL_skillcreator.md +23 -36
  12. package/templates/base/skill-creator/scripts/init_skill.py +18 -135
  13. package/templates/skills/ec/README.md +31 -0
  14. package/templates/skills/ec/aws/SKILL.md +1020 -0
  15. package/templates/skills/ec/aws/defaults.yaml +13 -0
  16. package/templates/skills/ec/aws/references/common_patterns.md +80 -0
  17. package/templates/skills/ec/aws/references/mcp_servers.md +98 -0
  18. package/templates/skills/ec/aws-terraform/SKILL.md +349 -0
  19. package/templates/skills/ec/aws-terraform/references/best_practices.md +394 -0
  20. package/templates/skills/ec/aws-terraform/references/checkov_reference.md +337 -0
  21. package/templates/skills/ec/aws-terraform/scripts/configure_mcp.py +150 -0
  22. package/templates/skills/ec/confluent-kafka/SKILL.md +655 -0
  23. package/templates/skills/ec/confluent-kafka/references/ansible_playbooks.md +792 -0
  24. package/templates/skills/ec/confluent-kafka/references/ec_deployment.md +579 -0
  25. package/templates/skills/ec/confluent-kafka/references/kraft_migration.md +490 -0
  26. package/templates/skills/ec/confluent-kafka/references/troubleshooting.md +778 -0
  27. package/templates/skills/ec/confluent-kafka/references/upgrade_7x_to_8x.md +488 -0
  28. package/templates/skills/ec/confluent-kafka/scripts/kafka_health_check.py +435 -0
  29. package/templates/skills/ec/confluent-kafka/scripts/upgrade_preflight.py +568 -0
  30. package/templates/skills/ec/confluent-kafka/scripts/validate_config.py +455 -0
  31. package/templates/skills/ec/consul/SKILL.md +427 -0
  32. package/templates/skills/ec/consul/references/acl_setup.md +168 -0
  33. package/templates/skills/ec/consul/references/ha_config.md +196 -0
  34. package/templates/skills/ec/consul/references/troubleshooting.md +267 -0
  35. package/templates/skills/ec/consul/references/upgrades.md +213 -0
  36. package/templates/skills/ec/consul/scripts/consul_health_report.py +530 -0
  37. package/templates/skills/ec/consul/scripts/consul_status.py +264 -0
  38. package/templates/skills/ec/consul/scripts/generate_values.py +170 -0
  39. package/templates/skills/ec/documentation/SKILL.md +351 -0
  40. package/templates/skills/ec/documentation/references/best_practices.md +201 -0
  41. package/templates/skills/ec/documentation/scripts/analyze_code.py +307 -0
  42. package/templates/skills/ec/documentation/scripts/detect_changes.py +460 -0
  43. package/templates/skills/ec/documentation/scripts/generate_changelog.py +312 -0
  44. package/templates/skills/ec/documentation/scripts/sync_docs.py +272 -0
  45. package/templates/skills/ec/documentation/scripts/update_skill_docs.py +366 -0
  46. package/templates/skills/ec/gitlab/SKILL.md +529 -0
  47. package/templates/skills/ec/gitlab/references/agent_installation.md +416 -0
  48. package/templates/skills/ec/gitlab/references/api_reference.md +508 -0
  49. package/templates/skills/ec/gitlab/references/gitops_flux.md +465 -0
  50. package/templates/skills/ec/gitlab/references/troubleshooting.md +518 -0
  51. package/templates/skills/ec/gitlab/scripts/generate_agent_values.py +329 -0
  52. package/templates/skills/ec/gitlab/scripts/gitlab_agent_status.py +414 -0
  53. package/templates/skills/ec/jira/SKILL.md +484 -0
  54. package/templates/skills/ec/jira/references/jql_reference.md +148 -0
  55. package/templates/skills/ec/jira/scripts/add_comment.py +91 -0
  56. package/templates/skills/ec/jira/scripts/bulk_log_work.py +124 -0
  57. package/templates/skills/ec/jira/scripts/create_ticket.py +162 -0
  58. package/templates/skills/ec/jira/scripts/get_ticket.py +191 -0
  59. package/templates/skills/ec/jira/scripts/jira_client.py +383 -0
  60. package/templates/skills/ec/jira/scripts/log_work.py +154 -0
  61. package/templates/skills/ec/jira/scripts/search_tickets.py +104 -0
  62. package/templates/skills/ec/jira/scripts/update_comment.py +67 -0
  63. package/templates/skills/ec/jira/scripts/update_ticket.py +161 -0
  64. package/templates/skills/ec/karpenter/SKILL.md +301 -0
  65. package/templates/skills/ec/karpenter/references/ec2nodeclasses.md +421 -0
  66. package/templates/skills/ec/karpenter/references/migration.md +396 -0
  67. package/templates/skills/ec/karpenter/references/nodepools.md +400 -0
  68. package/templates/skills/ec/karpenter/references/troubleshooting.md +359 -0
  69. package/templates/skills/ec/karpenter/scripts/generate_ec2nodeclass.py +187 -0
  70. package/templates/skills/ec/karpenter/scripts/generate_nodepool.py +245 -0
  71. package/templates/skills/ec/karpenter/scripts/karpenter_status.py +359 -0
  72. package/templates/skills/ec/opensearch/SKILL.md +720 -0
  73. package/templates/skills/ec/opensearch/references/ml_neural_search.md +576 -0
  74. package/templates/skills/ec/opensearch/references/operator.md +532 -0
  75. package/templates/skills/ec/opensearch/references/query_dsl.md +532 -0
  76. package/templates/skills/ec/opensearch/scripts/configure_mcp.py +148 -0
  77. package/templates/skills/ec/victoriametrics/SKILL.md +598 -0
  78. package/templates/skills/ec/victoriametrics/references/kubernetes.md +531 -0
  79. package/templates/skills/ec/victoriametrics/references/prometheus_migration.md +333 -0
  80. package/templates/skills/ec/victoriametrics/references/troubleshooting.md +442 -0
  81. package/templates/skills/knowledge/SKILLS_CATALOG.md +274 -4
  82. package/templates/skills/knowledge/intelligent-routing/SKILL.md +237 -164
  83. package/templates/skills/knowledge/parallel-agents/SKILL.md +345 -73
  84. package/templates/skills/knowledge/plugin-discovery/SKILL.md +582 -0
  85. package/templates/skills/knowledge/plugin-discovery/scripts/platform_setup.py +1083 -0
  86. package/templates/skills/knowledge/design-md/README.md +0 -34
  87. package/templates/skills/knowledge/design-md/SKILL.md +0 -193
  88. package/templates/skills/knowledge/design-md/examples/DESIGN.md +0 -154
  89. package/templates/skills/knowledge/notebooklm-mcp/SKILL.md +0 -71
  90. package/templates/skills/knowledge/notebooklm-mcp/assets/example_asset.txt +0 -24
  91. package/templates/skills/knowledge/notebooklm-mcp/references/api_reference.md +0 -34
  92. package/templates/skills/knowledge/notebooklm-mcp/scripts/example.py +0 -19
  93. package/templates/skills/knowledge/react-components/README.md +0 -36
  94. package/templates/skills/knowledge/react-components/SKILL.md +0 -53
  95. package/templates/skills/knowledge/react-components/examples/gold-standard-card.tsx +0 -80
  96. package/templates/skills/knowledge/react-components/package-lock.json +0 -231
  97. package/templates/skills/knowledge/react-components/package.json +0 -16
  98. package/templates/skills/knowledge/react-components/resources/architecture-checklist.md +0 -15
  99. package/templates/skills/knowledge/react-components/resources/component-template.tsx +0 -37
  100. package/templates/skills/knowledge/react-components/resources/stitch-api-reference.md +0 -14
  101. package/templates/skills/knowledge/react-components/resources/style-guide.json +0 -27
  102. package/templates/skills/knowledge/react-components/scripts/fetch-stitch.sh +0 -30
  103. package/templates/skills/knowledge/react-components/scripts/validate.js +0 -68
  104. package/templates/skills/knowledge/self-update/SKILL.md +0 -60
  105. package/templates/skills/knowledge/self-update/scripts/update_kit.py +0 -103
  106. package/templates/skills/knowledge/stitch-loop/README.md +0 -54
  107. package/templates/skills/knowledge/stitch-loop/SKILL.md +0 -235
  108. package/templates/skills/knowledge/stitch-loop/examples/SITE.md +0 -73
  109. package/templates/skills/knowledge/stitch-loop/examples/next-prompt.md +0 -25
  110. package/templates/skills/knowledge/stitch-loop/resources/baton-schema.md +0 -61
  111. package/templates/skills/knowledge/stitch-loop/resources/site-template.md +0 -104
@@ -11,7 +11,6 @@ Examples:
11
11
  init_skill.py custom-skill --path /custom/location
12
12
  """
13
13
 
14
- import subprocess
15
14
  import sys
16
15
  from pathlib import Path
17
16
 
@@ -267,134 +266,27 @@ def init_skill(skill_name, path):
267
266
  print("1. Edit SKILL.md to complete the TODO items and update the description")
268
267
  print("2. Customize or delete the example files in scripts/, references/, and assets/")
269
268
  print("3. Run the validator when ready to check the skill structure")
269
+ print("4. Update the skills catalog: python skill-creator/scripts/update_catalog.py --skills-dir skills/")
270
270
 
271
271
  return skill_dir
272
272
 
273
273
 
274
- def auto_update_catalog(skills_dir: Path) -> bool:
275
- """
276
- Auto-run update_catalog.py after skill creation.
277
-
278
- Args:
279
- skills_dir: Path to the skills directory
280
-
281
- Returns:
282
- True if successful, False otherwise
283
- """
284
- # Locate update_catalog.py relative to this script
285
- script_dir = Path(__file__).resolve().parent
286
- catalog_script = script_dir / "update_catalog.py"
287
-
288
- if not catalog_script.exists():
289
- print(f" āš ļø Could not find update_catalog.py at {catalog_script}")
290
- return False
291
-
292
- print(f"\nšŸ“š Auto-updating skills catalog...")
293
- try:
294
- result = subprocess.run(
295
- [sys.executable, str(catalog_script), "--skills-dir", str(skills_dir)],
296
- capture_output=True,
297
- text=True,
298
- timeout=30,
299
- )
300
- if result.returncode == 0:
301
- print("āœ… Skills catalog updated automatically")
302
- return True
303
- else:
304
- print(f" āš ļø Catalog update returned non-zero: {result.stderr.strip()}")
305
- return False
306
- except subprocess.TimeoutExpired:
307
- print(" āš ļø Catalog update timed out (30s)")
308
- return False
309
- except Exception as e:
310
- print(f" āš ļø Catalog update failed: {e}")
311
- return False
312
-
313
-
314
- def auto_update_docs(skills_dir: Path, skill_name: str) -> bool:
315
- """
316
- Auto-run documentation sync after skill creation.
317
-
318
- Args:
319
- skills_dir: Path to the skills directory
320
- skill_name: Name of the skill to update docs for
321
-
322
- Returns:
323
- True if successful, False otherwise
324
- """
325
- # Locate sync_docs.py in the documentation skill
326
- sync_script = skills_dir / "documentation" / "scripts" / "sync_docs.py"
327
-
328
- if not sync_script.exists():
329
- # Documentation skill not installed — silently skip
330
- return False
331
-
332
- print(f"\nšŸ“ Auto-updating documentation...")
333
- try:
334
- result = subprocess.run(
335
- [
336
- sys.executable, str(sync_script),
337
- "--skills-dir", str(skills_dir),
338
- "--update-catalog", "true",
339
- ],
340
- capture_output=True,
341
- text=True,
342
- timeout=60,
343
- )
344
- if result.returncode == 0:
345
- print("āœ… Documentation updated automatically")
346
- return True
347
- else:
348
- # sync_docs may not exist or have issues — non-fatal
349
- print(f" āš ļø Documentation sync skipped: {result.stderr.strip()[:200]}")
350
- return False
351
- except subprocess.TimeoutExpired:
352
- print(" āš ļø Documentation sync timed out (60s)")
353
- return False
354
- except Exception as e:
355
- print(f" āš ļø Documentation sync skipped: {e}")
356
- return False
357
-
358
-
359
274
  def main():
360
- import argparse
361
-
362
- parser = argparse.ArgumentParser(
363
- description="Initialize a new skill from template with auto-update of catalog and docs.",
364
- formatter_class=argparse.RawDescriptionHelpFormatter,
365
- epilog="""
366
- Examples:
367
- init_skill.py my-new-skill --path skills/
368
- init_skill.py my-api-helper --path skills/ --no-auto-update
369
- init_skill.py custom-skill --path /custom/location --skills-dir skills/
370
-
371
- Skill name requirements:
372
- - Hyphen-case identifier (e.g., 'data-analyzer')
373
- - Lowercase letters, digits, and hyphens only
374
- - Max 40 characters
375
- - Must match directory name exactly
376
- """,
377
- )
378
- parser.add_argument("skill_name", help="Name of the skill to create")
379
- parser.add_argument("--path", required=True, help="Directory where skill folder will be created")
380
- parser.add_argument(
381
- "--no-auto-update",
382
- action="store_true",
383
- default=False,
384
- help="Skip automatic catalog and documentation updates (default: auto-update ON)",
385
- )
386
- parser.add_argument(
387
- "--skills-dir",
388
- default=None,
389
- help="Skills directory for catalog/docs update (default: same as --path)",
390
- )
391
-
392
- # Support legacy positional format: init_skill.py <name> --path <path>
393
- args = parser.parse_args()
275
+ if len(sys.argv) < 4 or sys.argv[2] != '--path':
276
+ print("Usage: init_skill.py <skill-name> --path <path>")
277
+ print("\nSkill name requirements:")
278
+ print(" - Hyphen-case identifier (e.g., 'data-analyzer')")
279
+ print(" - Lowercase letters, digits, and hyphens only")
280
+ print(" - Max 40 characters")
281
+ print(" - Must match directory name exactly")
282
+ print("\nExamples:")
283
+ print(" init_skill.py my-new-skill --path skills/public")
284
+ print(" init_skill.py my-api-helper --path skills/private")
285
+ print(" init_skill.py custom-skill --path /custom/location")
286
+ sys.exit(1)
394
287
 
395
- skill_name = args.skill_name
396
- path = args.path
397
- skills_dir = Path(args.skills_dir or path).resolve()
288
+ skill_name = sys.argv[1]
289
+ path = sys.argv[3]
398
290
 
399
291
  print(f"šŸš€ Initializing skill: {skill_name}")
400
292
  print(f" Location: {path}")
@@ -402,19 +294,10 @@ Skill name requirements:
402
294
 
403
295
  result = init_skill(skill_name, path)
404
296
 
405
- if not result:
406
- sys.exit(1)
407
-
408
- # Auto-update catalog and documentation (unless explicitly disabled)
409
- if not args.no_auto_update:
410
- auto_update_catalog(skills_dir)
411
- auto_update_docs(skills_dir, skill_name)
297
+ if result:
298
+ sys.exit(0)
412
299
  else:
413
- print("\nā­ļø Auto-update skipped (--no-auto-update)")
414
- print(f" Manual update: python skill-creator/scripts/update_catalog.py --skills-dir {skills_dir}")
415
-
416
- print(f"\nšŸŽ‰ Done! Skill '{skill_name}' is ready for development.")
417
- sys.exit(0)
300
+ sys.exit(1)
418
301
 
419
302
 
420
303
  if __name__ == "__main__":
@@ -0,0 +1,31 @@
1
+ # EC Skills (Private)
2
+
3
+ > āš ļø **Private Branch Only** - These skills are exclusive to the `ec` protected branch.
4
+
5
+ This directory contains European Commission (EC) specific infrastructure skills that require private access to EC systems:
6
+
7
+ ## Skills Included
8
+
9
+ | Skill | Purpose |
10
+ | ------------------ | --------------------------------- |
11
+ | `aws/` | AWS MCP hub for EC infrastructure |
12
+ | `aws-terraform/` | Terraform/Terragrunt deployments |
13
+ | `confluent-kafka/` | Kafka cluster management |
14
+ | `consul/` | HashiCorp Consul on EKS |
15
+ | `gitlab/` | GitLab agent management (on-prem) |
16
+ | `jira/` | CITnet Jira integration |
17
+ | `karpenter/` | EKS autoscaler |
18
+ | `opensearch/` | OpenSearch management |
19
+ | `victoriametrics/` | Time-series database |
20
+ | `documentation/` | Documentation automation |
21
+
22
+ ## Access Requirements
23
+
24
+ - EC VPN or network access
25
+ - AWS credentials for EC accounts
26
+ - CITnet Jira API token
27
+ - GitLab on-premise access
28
+
29
+ ## Branch Information
30
+
31
+ These skills are only included in the `ec` protected branch and are not distributed with the public `main` branch.