Initial commit

skills/registry.diff/skill.yaml

@@ -0,0 +1,110 @@
+name: registry.diff
+version: 0.2.0
+description: >
+  Compare current and previous versions of skills/agents and report differences.
+  Detects changes, determines required actions, and provides suggestions for
+  version management and breaking change prevention. Enhanced with changed_fields
+  array and breaking flag for easier consumption.
+
+# Input parameters
+inputs:
+  - name: manifest_path
+    type: string
+    required: true
+    description: Path to the skill.yaml or agent.yaml manifest file to compare
+
+# Output files/data
+outputs:
+  - name: diff_result
+    type: object
+    description: >
+      Detailed diff analysis including diff_type, required_action, suggestions,
+      and comparison details
+
+# Skills this depends on
+dependencies: []
+
+# Lifecycle status
+status: active
+
+# Entrypoints define how the skill is invoked
+entrypoints:
+  - command: /registry/diff
+    handler: registry_diff.py
+    runtime: python
+    description: >
+      Compare a manifest against its registry entry to detect changes and
+      determine appropriate actions.
+    parameters:
+      - name: manifest_path
+        type: string
+        required: true
+        description: >
+          Path to the skill.yaml or agent.yaml manifest file to analyze.
+          Can be absolute or relative path.
+    permissions:
+      - filesystem
+      - read
+
+# Return values
+returns:
+  diff_type:
+    type: string
+    enum:
+      - new
+      - version_bump
+      - version_downgrade
+      - permission_change
+      - breaking_change
+      - status_change
+      - needs_version_bump
+      - no_change
+    description: Classification of the detected changes
+
+  required_action:
+    type: string
+    enum:
+      - register
+      - review
+      - reject
+      - skip
+    description: Recommended action based on the analysis
+
+  changed_fields:
+    type: array
+    items:
+      type: string
+    description: >
+      List of field names that changed between the manifest and registry entry
+      (e.g., version, permissions, status, description, inputs, outputs, etc.)
+
+  breaking:
+    type: boolean
+    description: >
+      Indicates whether the changes are breaking (e.g., version downgrade,
+      removed fields without version bump, removed permissions without version bump)
+
+  suggestions:
+    type: array
+    items:
+      type: string
+    description: >
+      List of suggestions for addressing the detected changes,
+      including version bump recommendations
+
+# Exit codes
+exit_codes:
+  0: >
+    Success - changes are acceptable (new entry, clean version bump,
+    or no significant changes)
+  1: >
+    Failure - breaking or unauthorized changes detected (version downgrade,
+    removed fields without version bump, unauthorized permission changes)
+
+# Tags for categorization
+tags:
+  - registry
+  - validation
+  - version-control
+  - diff
+  - comparison