Skip to content

aiskillstore/marketplace / skills/aaravkashyap12/advise-project-approach

advise-project-approach

Flagged

Research and advise on the best way to approach a software project, including architecture, tech stack, implementation strategy, pricing/operating-cost tradeoffs, benchmark research, and comparisons with similar real-world projects. Use before building, mid-build, or after completion when the user asks for project strategy, optimal approach, research comparables, similar projects, stack selection, vendor/service choice, repo analysis, architecture critique, implementation feedback, or a prioritized improvement plan. Avoid for narrow single-bug debugging or isolated file edits unless the user asks for broader project direction.

FileKindSize
SKILL.mdskill md30.1 KB
agents/openai.yamlconfig310 B
skill-report.jsonconfig31.3 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-08-12T04:52:58.145Z",
    "slug": "aaravkashyap12-advise-project-approach",
    "source_url": "https://github.com/aaravkashyap12/advise-project-approach/tree/88f1ecc7229f95f066c6e00bda3bdf901595a117/skills/advise-project-approach",
    "source_ref": "88f1ecc7229f95f066c6e00bda3bdf901595a117",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "aaaabcc3e665c3d58c81b4ec5eb7bd063fe19c43bd478341741a1bec59d5a1fe",
    "tree_hash": "bbd8fb4114f018aa3c27b320912124609ba13da3499d62ce1f650f690ed4b810",
    "provenance": {
      "model_effective": "codex",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    },
    "upstream_version_raw": null,
    "upstream_version_normalized": null,
    "upstream_version_source": "none",
    "upstream_version_status": "missing",
    "upstream_commit_sha": "88f1ecc7229f95f066c6e00bda3bdf901595a117"
  },
  "skill": {
    "name": "advise-project-approach",
    "description": "Research software project strategy, architecture, technology choices, implementation plans, operating costs, benchmarks, and comparable projects. Use it before building, during implementation, or after completion for broader project direction. It does not target narrow bug fixes or isolated file edits.",
    "summary": "Evaluate software project choices using repository evidence, current research, explicit tradeoffs, and prioritized next steps.",
    "icon": "📦",
    "author": "aaravkashyap12",
    "license": "MIT",
    "category": "research",
    "tags": [
      "software-architecture",
      "technology-selection",
      "project-planning",
      "repository-review",
      "cost-analysis"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "network"
    ]
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "All 31 static findings are false positives caused by Markdown formatting, a protective secret-file denylist, and ordinary project-research terminology. The skill enforces read-only inspection, permission gates, bounded browsing, and untrusted-content handling, with no evidence of prompt injection or malicious intent.",
    "remediation": [],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 103,
            "line_end": 103
          },
          {
            "file": "SKILL.md",
            "line_start": 104,
            "line_end": 104
          },
          {
            "file": "SKILL.md",
            "line_start": 105,
            "line_end": 105
          },
          {
            "file": "SKILL.md",
            "line_start": 162,
            "line_end": 162
          },
          {
            "file": "SKILL.md",
            "line_start": 167,
            "line_end": 167
          },
          {
            "file": "SKILL.md",
            "line_start": 168,
            "line_end": 168
          },
          {
            "file": "SKILL.md",
            "line_start": 340,
            "line_end": 380
          },
          {
            "file": "SKILL.md",
            "line_start": 380,
            "line_end": 382
          },
          {
            "file": "SKILL.md",
            "line_start": 382,
            "line_end": 382
          },
          {
            "file": "SKILL.md",
            "line_start": 386,
            "line_end": 435
          },
          {
            "file": "SKILL.md",
            "line_start": 435,
            "line_end": 437
          }
        ]
      },
      {
        "factor": "network",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 234,
            "line_end": 234
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:SKILL.md:103:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 103,
        "line_end": 103,
        "snippet": "- `.env` or `.env.*`"
      },
      {
        "id": "external_commands:SKILL.md:104:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 104,
        "line_end": 104,
        "snippet": "- `*.pem`, `*.key`, `id_rsa`, or SSH keys"
      },
      {
        "id": "external_commands:SKILL.md:105:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 105,
        "line_end": 105,
        "snippet": "- `credentials.json`, `secrets.*`, token files, or private config files"
      },
      {
        "id": "external_commands:SKILL.md:162:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 162,
        "line_end": 162,
        "snippet": "Use the fastest available read-only tools. Prefer `rg --files` for file discovery. If unavailable, u"
      },
      {
        "id": "external_commands:SKILL.md:167:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 167,
        "line_end": 167,
        "snippet": "- manifests such as `package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, `pom.xml`, `Gemfile`, "
      },
      {
        "id": "external_commands:SKILL.md:168:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 168,
        "line_end": 168,
        "snippet": "- entry points such as `main.*`, `index.*`, `app.*`, `server.*`, `cli.*`"
      },
      {
        "id": "external_commands:SKILL.md:340:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 340,
        "line_end": 380,
        "snippet": "```md"
      },
      {
        "id": "external_commands:SKILL.md:380:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 380,
        "line_end": 382,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:382:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 382,
        "line_end": 382,
        "snippet": "For a vague pre-build request, include an `Intake Summary` before `Project Frame`, or state that int"
      },
      {
        "id": "external_commands:SKILL.md:386:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 386,
        "line_end": 435,
        "snippet": "```md"
      },
      {
        "id": "external_commands:SKILL.md:435:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 435,
        "line_end": 437,
        "snippet": "```"
      },
      {
        "id": "network:SKILL.md:234:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 234,
        "line_end": 234,
        "snippet": "Agent-Reach may be used as an optional capability adapter for public web, GitHub, X, Reddit, YouTube"
      },
      {
        "id": "sensitive:SKILL.md:104:ssh-private-key-file",
        "category": "sensitive",
        "severity": "critical",
        "pattern": "SSH private key file",
        "file": "SKILL.md",
        "line_start": 104,
        "line_end": 104,
        "snippet": "- `*.pem`, `*.key`, `id_rsa`, or SSH keys"
      },
      {
        "id": "sensitive:SKILL.md:103:environment-file-access",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Environment file access",
        "file": "SKILL.md",
        "line_start": 103,
        "line_end": 103,
        "snippet": "- `.env` or `.env.*`"
      },
      {
        "id": "sensitive:SKILL.md:105:credential-json-file",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Credential JSON file",
        "file": "SKILL.md",
        "line_start": 105,
        "line_end": 105,
        "snippet": "- `credentials.json`, `secrets.*`, token files, or private config files"
      },
      {
        "id": "sensitive:SKILL.md:104:certificate-key-files",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Certificate/key files",
        "file": "SKILL.md",
        "line_start": 104,
        "line_end": 104,
        "snippet": "- `*.pem`, `*.key`, `id_rsa`, or SSH keys"
      },
      {
        "id": "blocker:SKILL.md:3:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 3,
        "line_end": 3,
        "snippet": "description: Research and advise on the best way to approach a software project, including architect"
      },
      {
        "id": "blocker:SKILL.md:118:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 118,
        "line_end": 118,
        "snippet": "5. **Check operating costs** - when a managed service, cloud provider, AI API, storage layer, auth p"
      },
      {
        "id": "blocker:SKILL.md:144:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 144,
        "line_end": 144,
        "snippet": "5. **Tradeoff matrix** - compare viable options across fit, build speed, maintenance, deployment, da"
      },
      {
        "id": "blocker:SKILL.md:152:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 152,
        "line_end": 152,
        "snippet": "- Did the recommendation depend on actual project constraints rather than generic popularity?"
      },
      {
        "id": "blocker:SKILL.md:153:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 153,
        "line_end": 153,
        "snippet": "- Did the recommendation account for real operating costs when pricing could change the decision?"
      },
      {
        "id": "blocker:SKILL.md:154:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 154,
        "line_end": 154,
        "snippet": "- Did the answer separate comparable projects found, transferable patterns, non-transferable details"
      },
      {
        "id": "blocker:SKILL.md:155:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 155,
        "line_end": 155,
        "snippet": "- Did every \"active\", \"maintained\", \"popular\", or \"production-ready\" claim have evidence and an exac"
      },
      {
        "id": "blocker:SKILL.md:156:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 156,
        "line_end": 156,
        "snippet": "- Did every price, quota, free-tier, or usage-limit claim come from a visible pricing/source page or"
      },
      {
        "id": "blocker:SKILL.md:157:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 157,
        "line_end": 157,
        "snippet": "- Did any section sound like a normal code review when no repo/code was inspected?"
      },
      {
        "id": "blocker:SKILL.md:158:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 158,
        "line_end": 158,
        "snippet": "- Did the answer include when the recommended approach would become the wrong approach?"
      },
      {
        "id": "blocker:SKILL.md:180:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 180,
        "line_end": 180,
        "snippet": "Avoid burning context on large projects. Always map first, then inspect selectively."
      },
      {
        "id": "blocker:SKILL.md:307:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 307,
        "line_end": 307,
        "snippet": "If exact prices are verified, cite them with source and observed date. If not verified, avoid number"
      },
      {
        "id": "blocker:SKILL.md:353:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 353,
        "line_end": 353,
        "snippet": "<Constraints considered, decision criteria, and how comparables influenced or did not influence the "
      },
      {
        "id": "blocker:SKILL.md:365:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 365,
        "line_end": 365,
        "snippet": "<How the project should be structured. Include a Mermaid or ASCII diagram when helpful.>"
      },
      {
        "id": "blocker:SKILL.md:294:network-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "Network reconnaissance",
        "file": "SKILL.md",
        "line_start": 294,
        "line_end": 295,
        "snippet": "- file/object storage, bandwidth, image/video transformations, CDN, and egress"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:SKILL.md:103:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks format the filename pattern `.env` in Markdown. The surrounding section explicitly forbids reading or exposing these files."
      },
      {
        "id": "external_commands:SKILL.md:104:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks mark private-key filename patterns as Markdown literals. No shell or Ruby execution is instructed."
      },
      {
        "id": "external_commands:SKILL.md:105:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks format credential filename examples inside a denylist. The text directs the agent not to read, print, summarize, or expose them."
      },
      {
        "id": "external_commands:SKILL.md:162:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is an inline reference to the read-only `rg --files` discovery command. It contains no dynamic input, command substitution, or execution syntax."
      },
      {
        "id": "external_commands:SKILL.md:167:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks identify common manifest filenames in Markdown. The line does not execute those files or any command."
      },
      {
        "id": "external_commands:SKILL.md:168:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks identify entry-point filename patterns for selective inspection. They are prose literals, not executable shell syntax."
      },
      {
        "id": "external_commands:SKILL.md:340:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The detected backticks open a fenced Markdown example that defines a report structure. The block contains no executable Ruby or shell code."
      },
      {
        "id": "external_commands:SKILL.md:380:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This line closes the fenced Markdown report example. It does not invoke a command interpreter."
      },
      {
        "id": "external_commands:SKILL.md:382:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks format the report heading `Intake Summary` as an inline literal. No command execution is present."
      },
      {
        "id": "external_commands:SKILL.md:386:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The detected sequence opens another fenced Markdown output template. Its contents are report headings and placeholders, not executable code."
      },
      {
        "id": "external_commands:SKILL.md:435:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This sequence closes the fenced Markdown output template. It has no shell execution semantics in this document."
      },
      {
        "id": "network:SKILL.md:234:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The URL identifies public documentation for an optional research adapter. The skill forbids automatic installation and requires authorization before configuration."
      },
      {
        "id": "sensitive:SKILL.md:104:ssh-private-key-file",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The private-key names appear only in a safety denylist. The instruction explicitly says not to read, print, summarize, or expose such files."
      },
      {
        "id": "sensitive:SKILL.md:103:environment-file-access",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "Environment files are named as prohibited sensitive files, not requested inputs. The surrounding instruction prevents access and disclosure."
      },
      {
        "id": "sensitive:SKILL.md:105:credential-json-file",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "Credential files are listed so they can be excluded from inspection. No credential access, collection, or transmission is requested."
      },
      {
        "id": "sensitive:SKILL.md:104:certificate-key-files",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "Certificate and key patterns are part of an explicit do-not-read list. This is protective guidance rather than sensitive-file access."
      },
      {
        "id": "blocker:SKILL.md:3:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The metadata describes software architecture and repository analysis. It does not request host, account, process, or security-control reconnaissance."
      },
      {
        "id": "blocker:SKILL.md:118:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The line asks for public pricing and service-limit research to support project decisions. It does not probe a target system or network."
      },
      {
        "id": "blocker:SKILL.md:144:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is a tradeoff matrix for comparing software options. The criteria are architectural and commercial, not reconnaissance activities."
      },
      {
        "id": "blocker:SKILL.md:152:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This self-check asks whether advice reflects supplied project constraints. It contains no system discovery instruction."
      },
      {
        "id": "blocker:SKILL.md:153:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This self-check concerns operating-cost assumptions. It neither enumerates nor probes system resources."
      },
      {
        "id": "blocker:SKILL.md:154:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The line checks the quality of comparisons with public projects. It is analytical guidance without reconnaissance behavior."
      },
      {
        "id": "blocker:SKILL.md:155:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The line requires evidence for maintenance and adoption claims. It promotes verifiable research and does not inspect a target system."
      },
      {
        "id": "blocker:SKILL.md:156:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The line requires visible sources for prices and quotas. This is public documentation research, not hostile reconnaissance."
      },
      {
        "id": "blocker:SKILL.md:157:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This self-check prevents unsupported code-review claims when no repository was inspected. It adds an evidence boundary rather than reconnaissance."
      },
      {
        "id": "blocker:SKILL.md:158:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The line asks the report to state failure conditions for its recommendation. It has no system-enumeration behavior."
      },
      {
        "id": "blocker:SKILL.md:180:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This instruction limits repository inspection by mapping first and sampling selectively. It is a bounded read-only review method."
      },
      {
        "id": "blocker:SKILL.md:307:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The line governs citation of public prices and discourages unverified numbers. It contains no system probing."
      },
      {
        "id": "blocker:SKILL.md:353:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is a placeholder for explaining decision criteria in a report template. It does not direct any reconnaissance."
      },
      {
        "id": "blocker:SKILL.md:365:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This placeholder requests a proposed project architecture diagram. It does not discover or probe host-system details."
      },
      {
        "id": "blocker:SKILL.md:294:network-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The line lists storage, bandwidth, CDN, and egress as cloud cost categories. It does not scan, enumerate, or connect to network targets."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 2,
    "total_lines": 467,
    "audit_model": "codex",
    "audited_at": "2026-08-12T04:52:58.146Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Choose the Best Project Approach",
    "value_statement": "Software project choices often rely on generic advice, incomplete evidence, or hidden operating costs. This skill produces evidence-based recommendations with explicit tradeoffs and next steps.",
    "seo_keywords": [
      "Claude project planning",
      "Codex architecture review",
      "Claude Code repository analysis",
      "software architecture advice",
      "technology stack selection",
      "project implementation strategy",
      "cloud cost comparison",
      "repository architecture review",
      "software project research"
    ],
    "actual_capabilities": [
      "Frames project goals, users, constraints, scale, budget, and deployment requirements.",
      "Reviews repository structure and selected architecture files using read-only inspection.",
      "Researches comparable projects, official documentation, pricing, and ecosystem guidance.",
      "Compares two to four viable stacks or architectures against explicit decision criteria.",
      "Recommends one path with alternatives, failure conditions, risks, and ordered next actions.",
      "Adapts reports for pre-build, mid-build, and post-build project stages."
    ],
    "limitations": [
      "Requires clear constraints or a short intake before providing a confident recommendation.",
      "Cannot verify current prices, releases, or comparables when browsing is unavailable.",
      "Does not run repository code, tests, builds, or installation commands without permission.",
      "Provides strategic review, not exhaustive security testing or narrow bug debugging."
    ],
    "use_cases": [
      {
        "title": "Plan a New Product",
        "description": "Select a practical stack, architecture, hosting model, and build sequence before implementation begins.",
        "target_user": "Solo developers and startup founders"
      },
      {
        "title": "Correct an Active Build",
        "description": "Review an existing repository and prioritize changes that improve fit, maintainability, cost, and delivery speed.",
        "target_user": "Engineering teams with active projects"
      },
      {
        "title": "Assess Launch Readiness",
        "description": "Compare a completed project with credible references and identify architecture, operations, security, and deployment gaps.",
        "target_user": "Technical leads preparing a release"
      }
    ],
    "prompt_templates": [
      {
        "title": "Frame a Project Idea",
        "prompt": "Help me plan [project] for [target users]. Ask the essential intake questions before recommending a stack or architecture.",
        "scenario": "Use when the project idea is early or constraints are unclear."
      },
      {
        "title": "Choose a Technology Stack",
        "prompt": "Compare suitable stacks for [project]. Consider my experience with [tools], budget of [budget], deadline of [deadline], and deployment preference of [target].",
        "scenario": "Use when requirements are known but the implementation stack is undecided."
      },
      {
        "title": "Review an Active Repository",
        "prompt": "Review the repository at [path or URL] using read-only inspection. Identify what to keep, change, and defer based on [project goals].",
        "scenario": "Use for a mid-build architecture and implementation review."
      },
      {
        "title": "Evaluate Architecture and Vendor Costs",
        "prompt": "Evaluate [current architecture] for [scale and compliance needs]. Research comparables and current vendor limits, then provide alternatives, migration risks, failure conditions, and prioritized actions.",
        "scenario": "Use for an advanced decision involving architecture, pricing, and operational tradeoffs."
      }
    ],
    "output_examples": [
      {
        "input": "Plan a low-cost appointment platform for one developer and local clinics.",
        "output": "Recommends a focused monolith, compares managed and self-hosted options, maps cost growth, and orders the first three vertical slices."
      },
      {
        "input": "Review my active repository and tell me whether the architecture should change.",
        "output": [
          "Summarizes inspected files and evidence gaps.",
          "Identifies strengths and prioritized architecture changes.",
          "Explains alternatives, migration costs, and conditions that would change the verdict."
        ]
      },
      {
        "input": "Assess whether this completed service is ready for production.",
        "output": "Produces a scoped readiness review covering architecture, reliability, security, deployment, observability, costs, and a prioritized improvement roadmap."
      }
    ],
    "best_practices": [
      "Provide target users, must-have workflows, team skills, budget, deadline, and deployment constraints.",
      "Share a repository path or public URL when requesting file-level findings.",
      "State whether community sources may be used and identify decisions requiring current pricing evidence."
    ],
    "anti_patterns": [
      "Do not request a definitive stack recommendation without supplying decision-critical constraints.",
      "Do not treat stars, popularity, or one comparable project as proof of fit.",
      "Do not assume repository review authorizes dependency installation or code execution."
    ],
    "faq": [
      {
        "question": "When should I use this skill?",
        "answer": "Use it before building, during implementation, or before launch when broader project direction matters."
      },
      {
        "question": "Can it review an existing repository?",
        "answer": "Yes. It maps the repository and selectively inspects relevant files using read-only methods."
      },
      {
        "question": "Will it run tests or install dependencies?",
        "answer": "Not by default. It asks for permission before commands that may execute code or change state."
      },
      {
        "question": "Does it research current tools and pricing?",
        "answer": "Yes, when browsing is available. It cites sources and observed dates for time-sensitive claims."
      },
      {
        "question": "Can it use community sources?",
        "answer": "Yes, after you opt into sources such as X, Reddit, or YouTube."
      },
      {
        "question": "Does it replace a security audit?",
        "answer": "No. It can assess security posture, but it does not perform exhaustive penetration testing or dependency auditing."
      }
    ]
  },
  "file_structure": [
    {
      "name": "agents",
      "type": "dir",
      "path": "agents",
      "children": [
        {
          "name": "openai.yaml",
          "type": "file",
          "path": "agents/openai.yaml",
          "lines": 5
        }
      ]
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 462
    }
  ]
}
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall