Skip to content

aiskillstore/marketplace / skills/0xmsc/develop

develop

Verified

General principles for exploring, developing, editing, and refactoring code. Use for codebase analysis, implementation tasks, and code quality improvements.

FileKindSize
SKILL.mdskill md1.4 KB
references/python.mdmarkdown407 B
skill-report.jsonconfig12.7 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-06T01:02:53.009Z",
    "slug": "0xmsc-develop",
    "source_url": "https://github.com/0xmsc/coding_assistant/tree/master/src/coding_assistant/skills/develop",
    "source_ref": "master",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "cccc1c8d2f74373dc9c1429426fc4912514dabf6e6ed78676417b7ef3ab72462",
    "tree_hash": "04cc647ae9426ac8058413e65a6ef655e47eb85d16d811f4c9d5a5519cfe7ccd",
    "provenance": {
      "model_requested": "gpt-5.5:high",
      "model_effective": "codex:gpt-5.5:high",
      "fallback_chain": [
        {
          "agent": "codex",
          "model": "gpt-5.5",
          "effort": "high",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "develop",
    "description": "General principles for exploring, developing, editing, and refactoring code. Use for codebase analysis, implementation tasks, and code quality improvements.",
    "summary": "Guides careful codebase exploration, implementation planning, safe editing, and verification.",
    "icon": "📦",
    "version": "1.0.0",
    "author": "0xmsc",
    "license": "MIT",
    "category": "coding",
    "tags": [
      "codebase-analysis",
      "refactoring",
      "git-safety",
      "python",
      "code-quality"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands"
    ]
  },
  "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 inline-code formatting and benign references to development tools. No prompt injection, malicious intent, data exfiltration, or unsafe command execution was found in the reviewed files.",
    "remediation": [],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 17,
            "line_end": 17
          },
          {
            "file": "SKILL.md",
            "line_start": 31,
            "line_end": 31
          },
          {
            "file": "SKILL.md",
            "line_start": 34,
            "line_end": 34
          },
          {
            "file": "SKILL.md",
            "line_start": 36,
            "line_end": 36
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "blocker:references/python.md:5:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/python.md",
        "line_start": 5,
        "line_end": 5,
        "snippet": "- **Avoid `if TYPE_CHECKING:` for Circular Dependencies**: Using `if TYPE_CHECKING:` to hide circula"
      },
      {
        "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": "- For complex strategy, use the `plan` skill."
      },
      {
        "id": "external_commands:SKILL.md:31:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 31,
        "line_end": 31,
        "snippet": "- **Python**: Refer to `references/python.md`."
      },
      {
        "id": "external_commands:SKILL.md:34:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 34,
        "line_end": 34,
        "snippet": "- **Prefer `edit_file`**: Use for targeted changes; avoid rewriting full files."
      },
      {
        "id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 36,
        "line_end": 36,
        "snippet": "- **Tools**: Use `fd` and `rg` for exploration; standard shell tools for navigation."
      },
      {
        "id": "blocker:SKILL.md:34:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 34,
        "line_end": 34,
        "snippet": "- **Prefer `edit_file`**: Use for targeted changes; avoid rewriting full files."
      }
    ],
    "finding_verdicts": [
      {
        "id": "blocker:references/python.md:5:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The line discusses Python type-checking imports and circular dependency design. It does not request host reconnaissance or collection of system information."
      },
      {
        "id": "external_commands:SKILL.md:17:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The backticks are Markdown formatting around the skill name `plan`. There is no shell execution, command interpolation, or executable Ruby syntax."
      },
      {
        "id": "external_commands:SKILL.md:31:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The backticks format the reference path `references/python.md` in prose. The line only directs readers to documentation and does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:34:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The backticks format the tool name `edit_file` in a file editing guideline. The instruction favors targeted edits and contains no shell execution behavior."
      },
      {
        "id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line names common search tools in Markdown inline code for repository exploration. It does not include dynamic command construction, hidden execution, or unsafe arguments."
      },
      {
        "id": "blocker:SKILL.md:34:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The line recommends targeted file edits and verification discipline. It has no relationship to system reconnaissance or environment probing."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 2,
    "total_lines": 43,
    "audit_model": "codex",
    "audited_at": "2026-07-06T01:02:53.009Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Improve Code Changes with Development Guidance",
    "value_statement": "Code edits can drift from project style or miss important edge cases. This skill guides Claude, Codex, and Claude Code through planning, implementation, and verification.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "code development skill",
      "codebase analysis",
      "refactoring guidance",
      "git safety",
      "software engineering workflow",
      "Python development",
      "code quality review"
    ],
    "actual_capabilities": [
      "Guides codebase exploration with fd, rg, and standard shell tools.",
      "Promotes readable, maintainable code and simple working solutions.",
      "Requires explicit approval before non-trivial implementation plans.",
      "Encourages git safety before repository initialization or branch changes.",
      "Directs Python work to import and circular dependency guidance.",
      "Emphasizes verification after file edits."
    ],
    "limitations": [
      "Does not include executable scripts or automated fixes.",
      "Provides broad process guidance, not full language documentation.",
      "Depends on the host AI tool to apply repository changes correctly.",
      "Does not replace project tests or human code review."
    ],
    "use_cases": [
      {
        "title": "Plan a Code Change",
        "description": "Structure a non-trivial implementation with clarifying questions, proposed answers, and an approval checkpoint.",
        "target_user": "Application developer"
      },
      {
        "title": "Refactor Existing Code",
        "description": "Improve maintainability while preserving local style, documenting intent, and checking edge cases.",
        "target_user": "Repository maintainer"
      },
      {
        "title": "Review Python Structure",
        "description": "Use the Python reference to spot import placement issues and circular dependency patterns.",
        "target_user": "Python team lead"
      }
    ],
    "prompt_templates": [
      {
        "title": "Explore a Repository",
        "prompt": "Use the develop skill to inspect this project and summarize its main structure, likely entry points, and verification commands.",
        "scenario": "Beginner repository orientation"
      },
      {
        "title": "Plan a Feature Change",
        "prompt": "Use the develop skill to plan this feature: [feature]. Ask clarifying questions with proposed answers before editing.",
        "scenario": "Small implementation planning"
      },
      {
        "title": "Refactor a Module",
        "prompt": "Use the develop skill to refactor [module] for readability while matching existing style and preserving behavior.",
        "scenario": "Focused maintainability work"
      },
      {
        "title": "Coordinate a Risky Change",
        "prompt": "Use the develop skill to create a staged plan for [large change], including edge cases, git safety checks, and verification steps.",
        "scenario": "Advanced multi-file change"
      }
    ],
    "output_examples": [
      {
        "input": "Improve a failing test workflow in a small service.",
        "output": [
          "A concise plan with clarifying questions and proposed answers.",
          "A focused implementation path that follows existing project style.",
          "Verification steps that include the relevant test command."
        ]
      },
      {
        "input": "Refactor a Python module with circular import pressure.",
        "output": [
          "A recommendation to move shared definitions into a separate module.",
          "A warning against hiding the issue with type-checking guards.",
          "A final check that imports remain at the top of the file."
        ]
      }
    ],
    "best_practices": [
      "Share the target files, expected behavior, and test command before implementation.",
      "Use the planning step for broad changes and approve the plan before edits start.",
      "Ask for verification results after file edits."
    ],
    "anti_patterns": [
      "Use it as a replacement for project-specific coding standards.",
      "Skip tests because the skill recommends simple solutions.",
      "Apply broad rewrites when targeted edits would solve the issue."
    ],
    "faq": [
      {
        "question": "What does this skill help with?",
        "answer": "It helps AI coding tools explore codebases, plan changes, edit carefully, and verify results."
      },
      {
        "question": "Does it run commands by itself?",
        "answer": "No. It provides guidance to the host AI tool, which controls any command execution."
      },
      {
        "question": "Can it handle Python projects?",
        "answer": "Yes. It includes a short Python reference for import placement and circular dependency cleanup."
      },
      {
        "question": "Is it only for large projects?",
        "answer": "No. It can guide small fixes, focused refactors, and larger planned changes."
      },
      {
        "question": "Does it replace testing?",
        "answer": "No. It explicitly encourages verification after edits and does not replace project tests."
      },
      {
        "question": "Which tools support it?",
        "answer": "It is listed for Claude, Codex, and Claude Code."
      }
    ]
  },
  "file_structure": [
    {
      "name": "references",
      "type": "dir",
      "path": "references",
      "children": [
        {
          "name": "python.md",
          "type": "file",
          "path": "references/python.md",
          "lines": 6
        }
      ]
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 37
    }
  ]
}
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