Skip to content

nddipiazza/robos / .github/skills/kgraph-insert

kgraph-insert

Verified

Insert or register a new architectural node (Microservice, Database, MessageBroker, App, etc.) into the Knowledge Graph with W3C SHACL shape validation gate.

Knowledge Graph Insert (kgraph-insert)

Insert a new architectural entity into the appropriate modular package store (.robos/kgraphs/<pkg>/package.jsonld) with an enforced W3C SHACL shape validation gate.

When to Use

  • Registering a newly scaffolded microservice, frontend application, database, or message broker.
  • Adding a new API contract (OpenAPI 3.1 YAML, Protobuf gRPC stub, or GraphQL schema).
  • Registering Model Context Protocol (MCP) servers or AI agent personas.

Execution

# Insert node from JSON file with SHACL validation
node packages/robos-graph/bin/kgraph-cli.js insert --file ./new-service.json

# Insert node via CLI flags
node packages/robos-graph/bin/kgraph-cli.js insert \
  --id "urn:robos:service:billing-api" \
  --type robos:Microservice \
  --title "Billing Microservice" \
  --package services
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
Agent Cost Reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
Agent Cost Reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall