Skip to content

aiskillstore/marketplace / skills/5minfutures/planning-guidelines

planning-guidelines

Verified

Core planning principles for Portfolio Buddy 2 development. Use when: planning any feature implementation, modification, or refactoring. Ensures code preservation, mobile/desktop optimization, and thorough requirement gathering.

FileKindSize
SKILL.mdskill md11.8 KB
skill-report.jsonconfig40.3 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-06T00:45:08.985Z",
    "slug": "5minfutures-planning-guidelines",
    "source_url": "https://github.com/5MinFutures/futures-arena/tree/main/.claude/skills/planning-guidelines",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "2778c17990afd229df72f84367c9d5247b3a20125ea71496c68852de7237dd50",
    "tree_hash": "b7daeac92572b6535abb44815e8da8d58105f33321ab3fb62223ad5855e6f7f6",
    "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": "planning-guidelines",
    "description": "A Portfolio Buddy 2 planning guide for conservative feature work, responsive UI decisions, and clear approval before major changes.",
    "summary": "Plan Portfolio Buddy 2 changes with preservation-first, responsive, approval-driven guidance.",
    "icon": "ðŸ“Ķ",
    "version": "1.0.0",
    "author": "5MinFutures",
    "license": "MIT",
    "tags": [
      "planning",
      "code-preservation",
      "responsive-design",
      "clarifying-questions",
      "portfolio-buddy"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands"
    ],
    "category": "coding"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "Manual review found the static findings are false positives caused by Markdown fences, inline code formatting, and ordinary planning prose. The skill is documentation-only and shows no executable shell commands, network access, credential handling, system reconnaissance, or prompt injection attempt.",
    "remediation": [],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 53,
            "line_end": 57
          },
          {
            "file": "SKILL.md",
            "line_start": 57,
            "line_end": 87
          },
          {
            "file": "SKILL.md",
            "line_start": 87,
            "line_end": 88
          },
          {
            "file": "SKILL.md",
            "line_start": 88,
            "line_end": 89
          },
          {
            "file": "SKILL.md",
            "line_start": 89,
            "line_end": 93
          },
          {
            "file": "SKILL.md",
            "line_start": 93,
            "line_end": 105
          },
          {
            "file": "SKILL.md",
            "line_start": 105,
            "line_end": 108
          },
          {
            "file": "SKILL.md",
            "line_start": 108,
            "line_end": 111
          },
          {
            "file": "SKILL.md",
            "line_start": 111,
            "line_end": 114
          },
          {
            "file": "SKILL.md",
            "line_start": 114,
            "line_end": 117
          },
          {
            "file": "SKILL.md",
            "line_start": 117,
            "line_end": 119
          },
          {
            "file": "SKILL.md",
            "line_start": 119,
            "line_end": 122
          },
          {
            "file": "SKILL.md",
            "line_start": 122,
            "line_end": 124
          },
          {
            "file": "SKILL.md",
            "line_start": 124,
            "line_end": 145
          },
          {
            "file": "SKILL.md",
            "line_start": 145,
            "line_end": 170
          },
          {
            "file": "SKILL.md",
            "line_start": 170,
            "line_end": 183
          },
          {
            "file": "SKILL.md",
            "line_start": 183,
            "line_end": 199
          },
          {
            "file": "SKILL.md",
            "line_start": 199,
            "line_end": 211
          },
          {
            "file": "SKILL.md",
            "line_start": 211,
            "line_end": 219
          },
          {
            "file": "SKILL.md",
            "line_start": 219,
            "line_end": 250
          },
          {
            "file": "SKILL.md",
            "line_start": 250,
            "line_end": 251
          },
          {
            "file": "SKILL.md",
            "line_start": 251,
            "line_end": 252
          },
          {
            "file": "SKILL.md",
            "line_start": 252,
            "line_end": 253
          },
          {
            "file": "SKILL.md",
            "line_start": 253,
            "line_end": 254
          },
          {
            "file": "SKILL.md",
            "line_start": 254,
            "line_end": 257
          },
          {
            "file": "SKILL.md",
            "line_start": 257,
            "line_end": 258
          },
          {
            "file": "SKILL.md",
            "line_start": 258,
            "line_end": 259
          },
          {
            "file": "SKILL.md",
            "line_start": 259,
            "line_end": 260
          },
          {
            "file": "SKILL.md",
            "line_start": 260,
            "line_end": 261
          },
          {
            "file": "SKILL.md",
            "line_start": 261,
            "line_end": 272
          },
          {
            "file": "SKILL.md",
            "line_start": 272,
            "line_end": 273
          },
          {
            "file": "SKILL.md",
            "line_start": 273,
            "line_end": 282
          },
          {
            "file": "SKILL.md",
            "line_start": 282,
            "line_end": 294
          },
          {
            "file": "SKILL.md",
            "line_start": 294,
            "line_end": 295
          },
          {
            "file": "SKILL.md",
            "line_start": 295,
            "line_end": 296
          },
          {
            "file": "SKILL.md",
            "line_start": 296,
            "line_end": 297
          },
          {
            "file": "SKILL.md",
            "line_start": 297,
            "line_end": 299
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:SKILL.md:53:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 53,
        "line_end": 57,
        "snippet": "```typescript"
      },
      {
        "id": "external_commands:SKILL.md:57:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 57,
        "line_end": 87,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:87:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 87,
        "line_end": 88,
        "snippet": "- `sm:` for small screens (640px+)"
      },
      {
        "id": "external_commands:SKILL.md:88:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 88,
        "line_end": 89,
        "snippet": "- `md:` for medium screens (768px+)"
      },
      {
        "id": "external_commands:SKILL.md:89:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 89,
        "line_end": 93,
        "snippet": "- `lg:` for large screens (1024px+)"
      },
      {
        "id": "external_commands:SKILL.md:93:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 93,
        "line_end": 105,
        "snippet": "- Use `touch-manipulation` CSS class for better touch response"
      },
      {
        "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": 108,
        "snippet": "```tsx"
      },
      {
        "id": "external_commands:SKILL.md:108:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 108,
        "line_end": 111,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 111,
        "line_end": 114,
        "snippet": "```tsx"
      },
      {
        "id": "external_commands:SKILL.md:114:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 114,
        "line_end": 117,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:117:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 117,
        "line_end": 119,
        "snippet": "```tsx"
      },
      {
        "id": "external_commands:SKILL.md:119:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 119,
        "line_end": 122,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:122:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 122,
        "line_end": 124,
        "snippet": "```tsx"
      },
      {
        "id": "external_commands:SKILL.md:124:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 124,
        "line_end": 145,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:145:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 145,
        "line_end": 170,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:170:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 170,
        "line_end": 183,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:183:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 183,
        "line_end": 199,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:199:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 199,
        "line_end": 211,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:211:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 211,
        "line_end": 219,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:219:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 219,
        "line_end": 250,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:250:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 250,
        "line_end": 251,
        "snippet": "- **Use with `planning-framework`** - Apply Musk's 5-step algorithm and ICE scoring for feature plan"
      },
      {
        "id": "external_commands:SKILL.md:251:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 251,
        "line_end": 252,
        "snippet": "- **Reference `coding-standards`** - Follow React 19 and TypeScript standards during implementation"
      },
      {
        "id": "external_commands:SKILL.md:252:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 252,
        "line_end": 253,
        "snippet": "- **Check `architecture-reference`** - Understand component hierarchy and existing patterns before a"
      },
      {
        "id": "external_commands:SKILL.md:253:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 253,
        "line_end": 254,
        "snippet": "- **Consult `migration-tracker`** - Verify feature parity and check for known issues before starting"
      },
      {
        "id": "external_commands:SKILL.md:254:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 254,
        "line_end": 257,
        "snippet": "- **Load `portfolio-context`** - Get tech stack and architectural constraints context"
      },
      {
        "id": "external_commands:SKILL.md:257:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 257,
        "line_end": 258,
        "snippet": "1. Load `planning-guidelines` (this skill) → Understand principles"
      },
      {
        "id": "external_commands:SKILL.md:258:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 258,
        "line_end": 259,
        "snippet": "2. Load `planning-framework` → Plan the feature approach"
      },
      {
        "id": "external_commands:SKILL.md:259:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 259,
        "line_end": 260,
        "snippet": "3. Check `architecture-reference` → Find where code goes"
      },
      {
        "id": "external_commands:SKILL.md:260:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 260,
        "line_end": 261,
        "snippet": "4. Apply `coding-standards` → Write the code correctly"
      },
      {
        "id": "external_commands:SKILL.md:261:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 261,
        "line_end": 272,
        "snippet": "5. Update `migration-tracker` → Document what was added"
      },
      {
        "id": "external_commands:SKILL.md:272:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 272,
        "line_end": 273,
        "snippet": "- Found existing code: `useState<number>(0)`"
      },
      {
        "id": "external_commands:SKILL.md:273:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 273,
        "line_end": 282,
        "snippet": "- Changed ONLY the default value: `useState<number>(4)`"
      },
      {
        "id": "external_commands:SKILL.md:282:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 282,
        "line_end": 294,
        "snippet": "- Kept existing `tradingPeriodDays` variable and display"
      },
      {
        "id": "external_commands:SKILL.md:294:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 294,
        "line_end": 295,
        "snippet": "- `className=\"flex items-center gap-1 sm:gap-2\"` (responsive spacing)"
      },
      {
        "id": "external_commands:SKILL.md:295:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 295,
        "line_end": 296,
        "snippet": "- `<span className=\"hidden sm:inline\">Total Margin</span>` (hide text on mobile)"
      },
      {
        "id": "external_commands:SKILL.md:296:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 296,
        "line_end": 297,
        "snippet": "- `className=\"h-3 w-3 sm:h-3.5 sm:w-3.5\"` (smaller icon on mobile)"
      },
      {
        "id": "external_commands:SKILL.md:297:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 297,
        "line_end": 299,
        "snippet": "- `touch-manipulation` class for better mobile interaction"
      },
      {
        "id": "blocker:SKILL.md:136:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 136,
        "line_end": 136,
        "snippet": "- Multiple valid approaches exist"
      },
      {
        "id": "blocker:SKILL.md:234:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 234,
        "line_end": 234,
        "snippet": "Avoid unnecessary complexity:"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:SKILL.md:53:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This is a Markdown code fence in a documentation example, not Ruby or shell execution. The skill contains prose and illustrative TypeScript or TSX snippets with no executable command path."
      },
      {
        "id": "external_commands:SKILL.md:57:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This is a Markdown code fence in a documentation example, not Ruby or shell execution. The skill contains prose and illustrative TypeScript or TSX snippets with no executable command path."
      },
      {
        "id": "external_commands:SKILL.md:87:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:88:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:89:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:93:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:105:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This is a Markdown code fence in a documentation example, not Ruby or shell execution. The skill contains prose and illustrative TypeScript or TSX snippets with no executable command path."
      },
      {
        "id": "external_commands:SKILL.md:108:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This is a Markdown code fence in a documentation example, not Ruby or shell execution. The skill contains prose and illustrative TypeScript or TSX snippets with no executable command path."
      },
      {
        "id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This is a Markdown code fence in a documentation example, not Ruby or shell execution. The skill contains prose and illustrative TypeScript or TSX snippets with no executable command path."
      },
      {
        "id": "external_commands:SKILL.md:114:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This is a Markdown code fence in a documentation example, not Ruby or shell execution. The skill contains prose and illustrative TypeScript or TSX snippets with no executable command path."
      },
      {
        "id": "external_commands:SKILL.md:117:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This is a Markdown code fence in a documentation example, not Ruby or shell execution. The skill contains prose and illustrative TypeScript or TSX snippets with no executable command path."
      },
      {
        "id": "external_commands:SKILL.md:119:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This is a Markdown code fence in a documentation example, not Ruby or shell execution. The skill contains prose and illustrative TypeScript or TSX snippets with no executable command path."
      },
      {
        "id": "external_commands:SKILL.md:122:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This is a Markdown code fence in a documentation example, not Ruby or shell execution. The skill contains prose and illustrative TypeScript or TSX snippets with no executable command path."
      },
      {
        "id": "external_commands:SKILL.md:124:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This is a Markdown code fence in a documentation example, not Ruby or shell execution. The skill contains prose and illustrative TypeScript or TSX snippets with no executable command path."
      },
      {
        "id": "external_commands:SKILL.md:145:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This is a Markdown code fence in a documentation example, not Ruby or shell execution. The skill contains prose and illustrative TypeScript or TSX snippets with no executable command path."
      },
      {
        "id": "external_commands:SKILL.md:170:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This is a Markdown code fence in a documentation example, not Ruby or shell execution. The skill contains prose and illustrative TypeScript or TSX snippets with no executable command path."
      },
      {
        "id": "external_commands:SKILL.md:183:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This is a Markdown code fence in a documentation example, not Ruby or shell execution. The skill contains prose and illustrative TypeScript or TSX snippets with no executable command path."
      },
      {
        "id": "external_commands:SKILL.md:199:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This is a Markdown code fence in a documentation example, not Ruby or shell execution. The skill contains prose and illustrative TypeScript or TSX snippets with no executable command path."
      },
      {
        "id": "external_commands:SKILL.md:211:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This is a Markdown code fence in a documentation example, not Ruby or shell execution. The skill contains prose and illustrative TypeScript or TSX snippets with no executable command path."
      },
      {
        "id": "external_commands:SKILL.md:219:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This is a Markdown code fence in a documentation example, not Ruby or shell execution. The skill contains prose and illustrative TypeScript or TSX snippets with no executable command path."
      },
      {
        "id": "external_commands:SKILL.md:250:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:251:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:252:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:253:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:254:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:257:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:258:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:259:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:260:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:261:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:272:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:273:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:282:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:294:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:295:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:296:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "external_commands:SKILL.md:297:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is inline Markdown formatting for Tailwind classes, skill names, or illustrative code text. It is documentation-only content and does not invoke a shell or accept user-controlled command input."
      },
      {
        "id": "blocker:SKILL.md:136:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The cited text is general planning guidance, not system reconnaissance. It does not request host details, enumerate files, or gather environment information."
      },
      {
        "id": "blocker:SKILL.md:234:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The cited text is general planning guidance, not system reconnaissance. It does not request host details, enumerate files, or gather environment information."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 1,
    "total_lines": 344,
    "audit_model": "codex",
    "audited_at": "2026-07-06T00:45:08.985Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Plan safer Portfolio Buddy changes",
    "value_statement": "Portfolio Buddy feature work can drift into risky refactors or mobile gaps. This skill guides Claude, Codex, and Claude Code to plan conservative, responsive changes.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "Portfolio Buddy 2",
      "planning guidelines",
      "responsive UI planning",
      "code preservation",
      "clarifying questions",
      "Tailwind CSS",
      "feature implementation"
    ],
    "actual_capabilities": [
      "Defines preservation-first rules for feature work and refactoring decisions.",
      "Provides criteria for proposing high-value improvements with user approval.",
      "Requires responsive Tailwind planning for mobile and desktop layouts.",
      "Supplies a clarifying question format with options, pros, cons, and recommendations.",
      "Shows Portfolio Buddy examples for financial metrics, state defaults, and responsive buttons."
    ],
    "limitations": [
      "Focused on Portfolio Buddy 2, so examples may need adaptation for other projects.",
      "Does not run tests, inspect repositories, or enforce code quality by itself.",
      "Does not replace product requirements, security review, or architecture approval.",
      "Assumes Tailwind and React-style patterns for many UI examples."
    ],
    "use_cases": [
      {
        "title": "Plan a safe feature change",
        "description": "Use the guide to preserve working code, identify risks, and request approval before larger changes.",
        "target_user": "Portfolio Buddy maintainer"
      },
      {
        "title": "Check responsive design choices",
        "description": "Apply the mobile and desktop checklist before adding UI controls, spacing, or visibility rules.",
        "target_user": "Frontend engineer"
      },
      {
        "title": "Standardize requirement gathering",
        "description": "Use the clarifying question format to compare options and explain trade-offs before implementation starts.",
        "target_user": "Technical lead"
      }
    ],
    "prompt_templates": [
      {
        "title": "Plan a small fix",
        "scenario": "Beginner request for a low-risk change.",
        "prompt": "Use the planning guidelines to plan this small Portfolio Buddy fix: [describe fix]. Preserve existing behavior and list mobile checks."
      },
      {
        "title": "Prepare clarification options",
        "scenario": "Requirements are unclear or have several valid interpretations.",
        "prompt": "Use the clarifying question format for this request: [describe request]. Give recommended and alternate options with trade-offs."
      },
      {
        "title": "Evaluate an improvement exception",
        "scenario": "A better implementation may require changing existing code.",
        "prompt": "Assess whether this proposed improvement meets the low-risk, high-upside, low-complexity criteria: [describe improvement]."
      },
      {
        "title": "Create a full implementation plan",
        "scenario": "Advanced planning before a feature or refactor.",
        "prompt": "Create a Portfolio Buddy implementation plan for [feature]. Include preservation strategy, responsive behavior, approval points, risks, and validation steps."
      }
    ],
    "output_examples": [
      {
        "input": "Plan a new dashboard control for starting capital.",
        "output": "A concise plan that extends the existing input, checks mobile touch targets, and asks whether the control should appear conditionally."
      },
      {
        "input": "Decide whether to replace a working calculation module.",
        "output": "An exception analysis that compares risk, upside, complexity, and approval needs before recommending preservation or targeted change."
      },
      {
        "input": "Prepare questions for ambiguous trading day logic.",
        "output": "A structured clarification with recommended and alternate interpretations, including pros, cons, and domain reasoning."
      }
    ],
    "best_practices": [
      "Start by identifying existing code that should be preserved.",
      "Check mobile and desktop behavior before calling a plan complete.",
      "Ask one clear clarification when requirements affect architecture or user experience."
    ],
    "anti_patterns": [
      "Replacing working code because a different pattern looks cleaner.",
      "Adding libraries or abstractions before proving they reduce real complexity.",
      "Guessing product behavior when a short clarification would prevent rework."
    ],
    "faq": [
      {
        "question": "What does this skill help with?",
        "answer": "It helps plan Portfolio Buddy 2 changes while preserving working code and responsive behavior."
      },
      {
        "question": "Does it write code automatically?",
        "answer": "No. It guides planning decisions and implementation criteria before code changes happen."
      },
      {
        "question": "Can it be used outside Portfolio Buddy 2?",
        "answer": "Yes, but project-specific examples and Tailwind assumptions may need adaptation."
      },
      {
        "question": "When should it ask clarifying questions?",
        "answer": "It should ask when requirements are ambiguous, architectural choices differ, or user experience could change."
      },
      {
        "question": "How does it handle refactoring?",
        "answer": "It defaults to preservation and only proposes improvement when risk is low, upside is high, and complexity stays low."
      },
      {
        "question": "Does it include security controls?",
        "answer": "It does not add security controls. It supports careful planning, approval, and validation habits."
      }
    ]
  },
  "file_structure": [
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 344
    }
  ]
}
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "侚čŪŪįšŠč́".Stars: 108kUpdated Claude CodeCodexVerifiedInstall