learnwy/lwy-project-skill-installer

Project Skill Installer

Analyze the project's tech stack, workflow, and pain points, then recommend the best skills to install. Always confirm with the user via AskUserQuestion before installing anything.

Core principle: First understand the project, then recommend, and install only after the user confirms.

Shared principle: This skill shares the 5 common writer disciplines with project-skill-writer / project-agent-writer / project-rules-writer. See ../project-skill-writer/references/writer-discipline.md for details.

Use Cases

Trigger when:

• The user says "install a skill", "find a skill for X", "what skills would help this project"
• The user describes a capability gap ("I wish AI would automatically...")
• The user wants to set up a new project with skills

Do not trigger when:

• The user wants to create a new skill (delegate to project-skill-writer)
• The user wants to create an agent (delegate to project-agent-writer)
• The user wants to create a rule (delegate to project-rules-writer)

Prerequisites

• Node.js >= 18
• Requires the globally available find-skills or trae-skill-finder skill
• If missing, prompt the user: npx skills add find-skills -g -y

Workflow

[L1: Understand the goal]
         ↓
[L2: Project analysis]
         ↓
[L3: Skill discovery]
         ↓
[L4: Recommend]  ← AskUserQuestion (confirmation required)
         ↓
[L5: Install]
         ↓
[L6: Verify]

L1: Understand the Goal

Extract the user's needs—do not ask "what skill do you want?" but understand:

| What the user says | Real need | |----------|----------| | "install a skill" | Vague—proceed to L2 analysis to find gaps | | "find a skill for testing" | Specific domain—search for testing skills | | "set up this project with skills" | Full audit—analyze the project and recommend a suite | | "I keep doing X manually" | Automation gap—find a skill that solves X |

L2: Project Analysis

Scan the project to build a tech profile. Use search tools in parallel:

Detection Targets

| Signal | What to look for | Tool | |------|----------|------| | Language | File extensions (.ts, .py, .swift, .go) | Glob | | Framework | package.json dependencies, Podfile, go.mod, Cargo.toml | Read | | Build tools | Makefile, webpack.config, vite.config, Bazel | Glob | | Testing | jest.config, pytest.ini, XCTest, go test | Glob | | CI/CD | .github/workflows/, Jenkinsfile, .gitlab-ci.yml | Glob | | Existing skills | .agents/skills/, .trae/skills/, .cursor/skills/ | Glob | | Existing rules | .agents/rules/, .trae/rules/ | Glob |

Tech Profile Output

Project: {name}
Language: TypeScript, Swift
Framework: React 18, UIKit
Build: Vite, Bazel
Testing: Jest, XCTest
CI: GitHub Actions
Existing skills: [list]
Existing rules: [list]

L3: Skill Discovery

Based on the tech profile and the user's goal, search for matching skills:

Search Strategy

1. Direct match: search by the user's exact request → npx skills find "<user_query>"
2. Tech match: search by the detected tech stack → npx skills find "react", npx skills find "swift"
3. Gap match: search by detected workflow gaps → if there is no testing skill, search npx skills find "testing"

Skill Sources (priority order)

1. Local registry: check globally installed skills in ~/.trae/skills/ and ~/.trae-cn/skills/
2. Community registry: npx skills find "<query>" — search the skills.sh marketplace
3. Bytedance registry: npx @tiktok-fe/skills find "<query>" — search the internal registry (if available)

Filtering Criteria

Reject skills that:

• Conflict with an installed skill (same purpose)
• Do not match the project's language/framework
• Are global-only (this skill installs project-level ones)
• Have no description or are clearly low quality

L4: Recommend (AskUserQuestion required)

Critical: Present recommendations via AskUserQuestion before installing any skill.

Recommendation Format

For each recommended skill, prepare:

Skill: {name}
Purpose: {what it does, one sentence}
Reason: {why it fits this project}
Install: {command}

AskUserQuestion Call

Use AskUserQuestion:

{
  "questions": [{
    "question": "Based on your {language/framework} project, I recommend these skills. Which would you like to install?",
    "header": "Skills",
    "multiSelect": true,
    "options": [
      {
        "label": "{skill-1-name} (Recommended)",
        "description": "{one sentence: what it does + why it fits}"
      },
      {
        "label": "{skill-2-name}",
        "description": "{one sentence: what it does + why it fits}"
      },
      {
        "label": "Skip",
        "description": "Don't install any skills right now"
      }
    ]
  }]
}

Rules:

• Put the most relevant skill first and mark it "(Recommended)"
• At most 4 options (3 skills + Skip)
• Put "Skip" as the last option
• Use multiSelect: true to allow multiple installs
• Never install before the user confirms

L5: Install

After the user confirms which skills to install:

Install Path Discovery

Use path discovery to determine the project-relative install path:

1. Check whether .agents/skills/ exists in the project root
2. Otherwise default to creating .agents/skills/ (no longer write to .trae/, .cursor/, .claude/—those are IDE-managed)

Install Commands

# Community skills (skills.sh)
npx skills add <package-name> --path <project-root>/.agents/skills/

# Bytedance internal skills
npx @tiktok-fe/skills add <package-name> --path <project-root>/.agents/skills/

Install Rules

• Always use a project-relative path — never ~/.trae/skills/, ~/.claude/skills/, or other global paths
• Do not install into the project's .trae/, .claude/, .cursor/—those are IDE-written directories
• Install skills one at a time, verifying each before moving to the next
• If an install fails, report the error and suggest manual installation steps

L6: Verify

Verify after installation:

• [ ] The skill directory exists at the expected path
• [ ] SKILL.md exists and is readable
• [ ] The skill description mentions relevant triggers
• [ ] No conflict with existing skills

Report to the user:

Installed {N} skills:
  ✓ {skill-1} → {path}
  ✓ {skill-2} → {path}

Usage: Just describe your need, and the skill activates automatically.

Error Handling

| Problem | Solution | |------|----------| | find-skills unavailable | Prompt: npx skills add find-skills -g -y | | No skill matches the query | Suggest creating a custom skill via project-skill-writer | | User requests a global install | Reject, explain the project-scope limitation, offer a project-relative alternative | | User requests creating an agent/rule | Route to project-agent-writer or project-rules-writer | | Install command fails | Show the error, suggest manual npx skills add <name> --path <path> | | Skill conflicts with an existing one | Show a comparison, ask the user which to keep |

Scope

This skill handles only:

• ✅ Analyzing the project's skill needs
• ✅ Searching skill registries
• ✅ Recommending skills with user confirmation
• ✅ Installing skills to a project-relative path
• ✅ Verifying the installation

This skill does not handle:

• ❌ Creating new skills → project-skill-writer
• ❌ Creating agents → project-agent-writer
• ❌ Creating rules → project-rules-writer
• ❌ Global installation (always scoped to the project)

References

• Path discovery — Install path determination
• Agent Skills core practices — AI skill best practices