skill-system-friction

Skill System Friction

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

Commands

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.

{
  "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
  }
}