# Technical Skill Finder

> Mine coding agent logs (Codex/Cursor/session histories and similar telemetry) to discover high-value candidate skills, then draft structured skill creation/reuse recommendations.

- **Type:** Skill
- **Install:** `agentstack add skill-vincentkoc-dotskills-technical-skill-finder`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [vincentkoc](https://agentstack.voostack.com/s/vincentkoc)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [vincentkoc](https://github.com/vincentkoc)
- **Source:** https://github.com/vincentkoc/dotskills/tree/main/skills/technical-skill-finder

## Install

```sh
agentstack add skill-vincentkoc-dotskills-technical-skill-finder
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Technical Skill Finder

## Purpose

Find recurring pain points from local agent logs and convert them into actionable skill candidates, reuse opportunities, or existing skill updates.

## When to use

- You want to discover missing technical skills from historical agent activity.
- You want reproducible criteria before creating a new skill.
- You want to validate whether an existing skill already covers the pattern.
- You want to include optional personal-signal sources (when authorized).

## Inputs

- `SCOPE` (required): repository paths, workspace, or tool domains to inspect.
- `SOURCES` (required): ordered source list to mine.
- `TIMEFRAME` (optional): default `all` unless constrained by user.
- `PRIVACY_POLICY` (required): explicit user direction for personal logs.
- `TOP_N` (optional): number of highest-priority candidates to return.

## Workflow

1. Initialize source set
   - `~/.codex/history.jsonl`
   - `~/.codex/archived_sessions/*.jsonl`
   - `~/.codex/sessions/*.jsonl` and `~/.codex/log/*` if present
   - Repository-specific telemetry in `AGENTS.md`/local docs when available
   - `Cursor` / `Codex` agent logs detected under known dotfiles directories
2. Normalize extraction signals
   - Parse stack traces and classify failure type (`auth`, `type-check`, `llm-error`, `git/ci`, `runtime`, `refactor-merge`, `test`)
   - Parse recurring command phrases (`rg`, `mypy`, `pytest`, `gh`, `git`, package-manager failures)
   - Record frequency, recency, and affected project context
3. Cluster signals
   - Group by: domain (python/js/rust/docs/tooling), command lineage, and error signature.
   - Deprioritize one-off sessions with low recurrence.
4. Map to existing skills
   - Compare candidate clusters with available skills by `name` and `description`.
   - If overlap is high, propose **skill update** path.
   - If no overlap, propose **new skill**.
5. Emit ranking output
   - Provide `impact`, `frequency`, `confidence`, `skill-fit`, and first-apply command set.
6. Produce minimal first-iteration artifacts for high-priority candidates
   - Candidate title + scope
   - Trigger phrase examples
   - Required inputs
   - Suggested workflow summary
   - Evidence snippets (line/file-level)
   - Suggested dependencies/tools (e.g., `jq`, `rg`, shell utilities, MCP resources)
7. Optional extension to personal-signal sources
   - Only after explicit approval to read personal channels.
   - If MCP is available and user has granted access, run MCP resource discovery and include message-signal-derived patterns.
   - Keep this opt-in and isolated from coding-signal output unless user requests a merged plan.

## Guardrails

- Never infer or emit private content from message logs unless explicitly permitted.
- Skip binary/corrupt files and summarize only parseable text sources.
- Prefer deterministic commands and small scripts over ad-hoc manual parsing.
- Always avoid proposing skills with unresolved operational context (credentials, environment, private URLs).
- If evidence is ambiguous, return `confidence: low` and request one more session sample.

## Outputs

- `skill_candidates.md`-style report in chat:
  - `reuse` candidates (existing skill can be extended)
  - `new` skill candidates (not yet covered)
  - top source anchors with references
  - recommended next action (create/update)

Read `references/sources.md` for source precedence.
Read `references/scorecard.md` for prioritization rules.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [vincentkoc](https://github.com/vincentkoc)
- **Source:** [vincentkoc/dotskills](https://github.com/vincentkoc/dotskills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-vincentkoc-dotskills-technical-skill-finder
- Seller: https://agentstack.voostack.com/s/vincentkoc
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.