Skip to content

aiskillstore/marketplace / skills/abdelstark/git-protocol

git-protocol

Verified

Git protocol implementation patterns using gitoxide for Guts repository operations

FileKindSize
SKILL.mdskill md6.6 KB
skill-report.jsonconfig24.7 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-07T17:46:47.028Z",
    "slug": "abdelstark-git-protocol",
    "source_url": "https://github.com/AbdelStark/guts/tree/main/.claude/skills/git-protocol",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "1aef86a2f61b0c1824014b205387aec668994b87eb37790d3d79fb5324ddc1dc",
    "tree_hash": "b72587018bebfeb51aa0e004f4b0d5e43d4d2f05c2092912f78e4a5f0e2b44a5",
    "provenance": {
      "model_effective": "codex",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "git-protocol",
    "description": "Guides Rust developers through Git-compatible repository operations using gitoxide and Guts patterns.",
    "summary": "Implement Git protocol operations with gitoxide-based Rust examples.",
    "icon": "📦",
    "version": "1.0.1",
    "author": "AbdelStark",
    "license": "MIT",
    "tags": [
      "git",
      "rust",
      "gitoxide",
      "protocol",
      "repositories"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "network"
    ],
    "category": "coding"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "The static findings are false positives caused by Markdown code formatting and illustrative Rust snippets. No executable shell commands, outbound HTTP clients, system reconnaissance, or prompt injection attempts were found in SKILL.md.",
    "remediation": [],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 14,
            "line_end": 14
          },
          {
            "file": "SKILL.md",
            "line_start": 15,
            "line_end": 15
          },
          {
            "file": "SKILL.md",
            "line_start": 16,
            "line_end": 16
          },
          {
            "file": "SKILL.md",
            "line_start": 17,
            "line_end": 17
          },
          {
            "file": "SKILL.md",
            "line_start": 18,
            "line_end": 18
          },
          {
            "file": "SKILL.md",
            "line_start": 24,
            "line_end": 37
          },
          {
            "file": "SKILL.md",
            "line_start": 37,
            "line_end": 41
          },
          {
            "file": "SKILL.md",
            "line_start": 41,
            "line_end": 66
          },
          {
            "file": "SKILL.md",
            "line_start": 66,
            "line_end": 70
          },
          {
            "file": "SKILL.md",
            "line_start": 70,
            "line_end": 129
          },
          {
            "file": "SKILL.md",
            "line_start": 129,
            "line_end": 135
          },
          {
            "file": "SKILL.md",
            "line_start": 135,
            "line_end": 188
          },
          {
            "file": "SKILL.md",
            "line_start": 188,
            "line_end": 192
          },
          {
            "file": "SKILL.md",
            "line_start": 192,
            "line_end": 220
          },
          {
            "file": "SKILL.md",
            "line_start": 220,
            "line_end": 224
          },
          {
            "file": "SKILL.md",
            "line_start": 224,
            "line_end": 262
          },
          {
            "file": "SKILL.md",
            "line_start": 262,
            "line_end": 266
          },
          {
            "file": "SKILL.md",
            "line_start": 266,
            "line_end": 289
          }
        ]
      },
      {
        "factor": "network",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 152,
            "line_end": 152
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:SKILL.md:14:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 14,
        "line_end": 14,
        "snippet": "- `gix`: High-level Git operations"
      },
      {
        "id": "external_commands:SKILL.md:15:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 15,
        "line_end": 15,
        "snippet": "- `gix-object`: Git object types"
      },
      {
        "id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 16,
        "line_end": 16,
        "snippet": "- `gix-hash`: Object ID handling"
      },
      {
        "id": "external_commands:SKILL.md:17:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 17,
        "line_end": 17,
        "snippet": "- `gix-pack`: Pack file operations"
      },
      {
        "id": "external_commands:SKILL.md:18:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 18,
        "line_end": 18,
        "snippet": "- `gix-transport`: Git protocol transport"
      },
      {
        "id": "external_commands:SKILL.md:24:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 24,
        "line_end": 37,
        "snippet": "```rust"
      },
      {
        "id": "external_commands:SKILL.md:37:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 37,
        "line_end": 41,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:41:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 41,
        "line_end": 66,
        "snippet": "```rust"
      },
      {
        "id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 66,
        "line_end": 70,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:70:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 70,
        "line_end": 129,
        "snippet": "```rust"
      },
      {
        "id": "external_commands:SKILL.md:129:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 129,
        "line_end": 135,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:135:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 135,
        "line_end": 188,
        "snippet": "```rust"
      },
      {
        "id": "external_commands:SKILL.md:188:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 188,
        "line_end": 192,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:192:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 192,
        "line_end": 220,
        "snippet": "```rust"
      },
      {
        "id": "external_commands:SKILL.md:220:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 220,
        "line_end": 224,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:224:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 224,
        "line_end": 262,
        "snippet": "```rust"
      },
      {
        "id": "external_commands:SKILL.md:262:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 262,
        "line_end": 266,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:266:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 266,
        "line_end": 289,
        "snippet": "```rust"
      },
      {
        "id": "network:SKILL.md:152:http-client-library",
        "category": "network",
        "severity": "low",
        "pattern": "HTTP client library",
        "file": "SKILL.md",
        "line_start": 152,
        "line_end": 152,
        "snippet": "let request = parse_upload_pack_request(&body)?;"
      },
      {
        "id": "blocker:SKILL.md:62:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 62,
        "line_end": 62,
        "snippet": "let id = self.repo.write_blob(data)?;"
      },
      {
        "id": "blocker:SKILL.md:125:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 125,
        "line_end": 125,
        "snippet": "let id = self.repo.write_object(&commit)?;"
      },
      {
        "id": "blocker:SKILL.md:211:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 211,
        "line_end": 211,
        "snippet": "for oid in objects {"
      },
      {
        "id": "blocker:SKILL.md:244:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 244,
        "line_end": 244,
        "snippet": "if let Some(old) = old_id {"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:SKILL.md:14:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This is a Markdown list item naming the gix crate, not Ruby or shell execution. There is no executable command or user-controlled input."
      },
      {
        "id": "external_commands:SKILL.md:15:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This is a Markdown list item naming the gix-object crate, not Ruby or shell execution. There is no executable command or user-controlled input."
      },
      {
        "id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This is a Markdown list item naming the gix-hash crate, not Ruby or shell execution. There is no executable command or user-controlled input."
      },
      {
        "id": "external_commands:SKILL.md:17:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This is a Markdown list item naming the gix-pack crate, not Ruby or shell execution. There is no executable command or user-controlled input."
      },
      {
        "id": "external_commands:SKILL.md:18:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This is a Markdown list item naming the gix-transport crate, not Ruby or shell execution. There is no executable command or user-controlled input."
      },
      {
        "id": "external_commands:SKILL.md:24:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This line opens a fenced Rust documentation example. It does not invoke Ruby backticks, shell execution, or an external process."
      },
      {
        "id": "external_commands:SKILL.md:37:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This line closes a fenced Rust documentation example. It does not invoke Ruby backticks, shell execution, or an external process."
      },
      {
        "id": "external_commands:SKILL.md:41:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This line opens a fenced Rust documentation example. It does not invoke Ruby backticks, shell execution, or an external process."
      },
      {
        "id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This line closes a fenced Rust documentation example. It does not invoke Ruby backticks, shell execution, or an external process."
      },
      {
        "id": "external_commands:SKILL.md:70:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This line opens a fenced Rust documentation example. It does not invoke Ruby backticks, shell execution, or an external process."
      },
      {
        "id": "external_commands:SKILL.md:129:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This line closes a fenced Rust documentation example. It does not invoke Ruby backticks, shell execution, or an external process."
      },
      {
        "id": "external_commands:SKILL.md:135:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This line opens a fenced Rust documentation example. It does not invoke Ruby backticks, shell execution, or an external process."
      },
      {
        "id": "external_commands:SKILL.md:188:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This line closes a fenced Rust documentation example. It does not invoke Ruby backticks, shell execution, or an external process."
      },
      {
        "id": "external_commands:SKILL.md:192:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This line opens a fenced Rust documentation example. It does not invoke Ruby backticks, shell execution, or an external process."
      },
      {
        "id": "external_commands:SKILL.md:220:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This line closes a fenced Rust documentation example. It does not invoke Ruby backticks, shell execution, or an external process."
      },
      {
        "id": "external_commands:SKILL.md:224:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This line opens a fenced Rust documentation example. It does not invoke Ruby backticks, shell execution, or an external process."
      },
      {
        "id": "external_commands:SKILL.md:262:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This line closes a fenced Rust documentation example. It does not invoke Ruby backticks, shell execution, or an external process."
      },
      {
        "id": "external_commands:SKILL.md:266:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This line opens a fenced Rust documentation example. It does not invoke Ruby backticks, shell execution, or an external process."
      },
      {
        "id": "network:SKILL.md:152:http-client-library",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "Line 152 parses an HTTP request body in a server-side Git upload-pack example. It does not use an HTTP client or send data externally."
      },
      {
        "id": "blocker:SKILL.md:62:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The code writes a Git blob to the repository object database. It does not inspect the host system or collect environment details."
      },
      {
        "id": "blocker:SKILL.md:125:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The code writes a Git commit object to the repository object database. It does not perform system reconnaissance or host enumeration."
      },
      {
        "id": "blocker:SKILL.md:211:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The loop iterates Git object identifiers selected for a packfile. It does not enumerate system resources or probe the runtime environment."
      },
      {
        "id": "blocker:SKILL.md:244:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "The conditional checks an optional old Git reference for an atomic update. It does not inspect system configuration or local host state."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 1,
    "total_lines": 290,
    "audit_model": "codex",
    "audited_at": "2026-07-07T17:46:47.028Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Implement Git Protocol Patterns",
    "value_statement": "Building Git-compatible repository services requires careful object, pack, and ref handling. This skill gives Claude, Codex, and Claude Code practical Rust patterns for gitoxide-based operations.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "git protocol",
      "gitoxide",
      "Rust Git",
      "Guts repository",
      "Smart HTTP",
      "packfile generation",
      "reference management"
    ],
    "actual_capabilities": [
      "Explains key gitoxide crates for objects, hashes, packs, and transport.",
      "Shows Rust patterns for opening or creating bare repositories.",
      "Demonstrates object reads, blob writes, commit construction, and reference updates.",
      "Outlines Smart HTTP upload-pack and receive-pack route handlers.",
      "Shows packfile generation from want and have object sets.",
      "Describes a Guts commit extension with signature verification metadata."
    ],
    "limitations": [
      "Provides illustrative Rust snippets, not a complete runnable service.",
      "Mentions permission checks but does not define a full authorization policy.",
      "Targets gitoxide and Guts-style repositories, so other Git libraries need adaptation.",
      "Does not cover shallow clone, partial clone, or recovery behavior in depth."
    ],
    "use_cases": [
      {
        "title": "Prototype Git Services",
        "description": "Use the patterns to sketch upload-pack, receive-pack, object storage, and ref update flows.",
        "target_user": "Rust backend developer"
      },
      {
        "title": "Review Repository Designs",
        "description": "Compare a planned Git-compatible service against the object, commit, packfile, and reference concepts shown here.",
        "target_user": "Technical lead"
      },
      {
        "title": "Extend Guts Integrations",
        "description": "Adapt the Guts commit metadata pattern for signed commits and consensus-related repository features.",
        "target_user": "Distributed systems engineer"
      }
    ],
    "prompt_templates": [
      {
        "title": "Explain the Building Blocks",
        "scenario": "Beginner orientation",
        "prompt": "Explain the gitoxide crates named in this skill and how they relate to Git objects, hashes, packs, and transport."
      },
      {
        "title": "Plan Repository Operations",
        "scenario": "Implementation planning",
        "prompt": "Using this skill, outline the steps for opening a bare repository, reading objects, writing blobs, and creating commits."
      },
      {
        "title": "Design Smart HTTP Flow",
        "scenario": "Protocol design",
        "prompt": "Use this skill to design an upload-pack and receive-pack flow with parsing, permission checks, packfile handling, and response types."
      },
      {
        "title": "Audit a Git Service Design",
        "scenario": "Advanced review",
        "prompt": "Review my gitoxide-based service design against this skill and identify missing validation, authorization, reference safety, and packfile handling steps."
      }
    ],
    "output_examples": [
      {
        "input": "Design a receive-pack flow for a Rust Git service.",
        "output": [
          "Parse commands and pack data from the request body.",
          "Verify push permissions before accepting repository mutations.",
          "Apply the packfile, then update each reference with atomic checks.",
          "Return a Git receive-pack response with a clear success or error result."
        ]
      },
      {
        "input": "Summarize the reference management pattern.",
        "output": "The skill shows listing references, updating references with expected old values, creating new references, and reading HEAD from the repository."
      },
      {
        "input": "Explain how Guts extends Git commits.",
        "output": "A Guts commit wraps a standard Git commit with an Ed25519 signature, signer public key, and optional consensus round metadata."
      }
    ],
    "best_practices": [
      "Validate Git object identifiers and request bodies before repository access.",
      "Check write permissions before applying packfiles or updating references.",
      "Use atomic reference updates when old object IDs are available."
    ],
    "anti_patterns": [
      "Do not treat the snippets as complete production code without missing service controls.",
      "Do not update references without checking expected old values when concurrency matters.",
      "Do not accept arbitrary pack data without size limits, validation, and permission checks."
    ],
    "faq": [
      {
        "question": "What does this skill help build?",
        "answer": "It helps design Git-compatible repository operations in Rust using gitoxide and Guts-oriented patterns."
      },
      {
        "question": "Does it provide a complete Git server?",
        "answer": "No. It provides implementation patterns and examples, but service wiring and production controls remain your responsibility."
      },
      {
        "question": "Which AI tools can use it?",
        "answer": "The report lists support for Claude, Codex, and Claude Code."
      },
      {
        "question": "Does it require network access?",
        "answer": "The skill describes Smart HTTP server handlers, but the skill file itself does not make network requests."
      },
      {
        "question": "What Rust library does it focus on?",
        "answer": "It focuses on gitoxide, including gix, gix-object, gix-hash, gix-pack, and gix-transport concepts."
      },
      {
        "question": "Is the sample code production-ready?",
        "answer": "No. Treat it as a starting point and add validation, authorization, limits, tests, and error handling."
      }
    ]
  },
  "file_structure": [
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 290
    }
  ]
}
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall