Claude
Skills
Sign in
Back

skill-system-friction

Included with Lifetime
$97 forever

Scan `.tkt/friction` records, classify blocker/workaround/papercut signals, compute frequencies, and suggest bounded skill-ification opportunities.

Generalscripts

What this skill does


# Skill System Friction

This skill provides a lightweight scan surface for recorded friction events.

## Commands

```bash
python3 "{skill_dir}/scripts/friction.py" scan
python3 "{skill_dir}/scripts/friction.py" scan --root /path/to/project
python3 "{skill_dir}/scripts/friction.py" survey-skills --root /path/to/project --output /path/to/audit/friction_survey_2026-04-11.md
```

## Rules

- Source of truth is `<root>/.tkt/friction/*.yaml`.
- Classification defaults to `other` for unknown types.
- Output is structured JSON and includes frequency summaries.
- `survey-skills` writes a markdown roadmap-planning report with one row per skill plus top-5 actions.

```skill-manifest
{
  "schema_version": "2.0",
  "id": "skill-system-friction",
  "version": "1.1.0",
  "capabilities": ["friction-scan", "friction-survey"],
  "effects": ["fs.read", "fs.write", "proc.exec"],
  "operations": {
    "scan": {
      "description": "Scan friction YAML files and return typed frequency analysis.",
      "input": {
        "root": {"type": "string", "required": false, "description": "Project root", "default": "."}
      },
      "output": {
        "description": "Typed friction report",
        "fields": {
          "counts": "object",
          "rows": "array",
          "frequencies": "array",
          "suggestions": "array"
        }
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/friction.py", "scan", "--root", "{root}"]
      }
    },
    "survey-skills": {
      "description": "Produce a per-skill friction survey for roadmap planning.",
      "input": {
        "root": {"type": "string", "required": false, "description": "Project root", "default": "."},
        "output": {"type": "string", "required": true, "description": "Markdown report path"},
        "focus_skills": {"type": "string", "required": false, "description": "Optional comma-separated focus skills"}
      },
      "output": {
        "description": "Per-skill friction survey report",
        "fields": {
          "report": "string",
          "rows": "array",
          "top_actions": "array"
        }
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/friction.py", "survey-skills", "--root", "{root}", "--output", "{output}"]
      }
    }
  },
  "stdout_contract": {
    "last_line_json": true
  }
}
```
Files: 5
Size: 30.3 KB
Complexity: 53/100
Category: General

Related in General