Skip to content
Back to search

ask-kit-skills

SkillWorks with Claude CodeGitHub

ask-kit kit: Claude Code skills and agents (subagents) on this machine and in the current repository: which skill or agent covers a job, what one says about a topic, which are installed and from where (user, project, plugin, claude.ai), which plugins the marketplaces offer, whether two overla

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/temet-ai--ask-kit-skills/badge.svg)](/listings/temet-ai--ask-kit-skills)

HTML

<a href="/listings/temet-ai--ask-kit-skills"><img src="/api/listings/temet-ai--ask-kit-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

You need [ask-kit](https://github.com/temet-ai/ask-kit#set-it-up) and Node.js.

Paste this into your agent:

Read ~/.config/ask-kit/AGENTS.md, then add this kit: github.com/temet-ai/ask-kit-skills

Or run it yourself:

ask-kit kit install temet-ai/ask-kit-skills        # shows what it reads, changes and runs
ask-kit kit install temet-ai/ask-kit-skills --yes  # installs and enables it

Restart your agents so `ask` lists `skills`. Project skills and agents come from the repository your agent works in; a question that names another folder is answered for that folder.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 77 lines
  1. # ask-kit-skills
  2. An [ask-kit](https://github.com/temet-ai/ask-kit) kit that lets your coding agent's `ask` tool
  3. answer questions about Claude Code skills and agents on your machine, and write, fix, rename and
  4. retire them when asked. A cheap model reads the skill and agent folders outside your agent's
  5. context and answers with names and `path:line`.
  6. Questions from its bench, of the kinds agents dug for by hand in skill and agent folders:
  7. - Which skill should I use to plan a night patrol route, and where does it live?
  8. - Does any skill or agent still mention morpork-report, the old name of the city-report skill? Which ones?
  9. - Is the frontmatter of the broken-skill skill valid? If not, what is wrong and on which line?
  10. ## Install
  11. You need [ask-kit](https://github.com/temet-ai/ask-kit#set-it-up) and Node.js.
  12. Paste this into your agent:
  13. ```
  14. Read ~/.config/ask-kit/AGENTS.md, then add this kit: github.com/temet-ai/ask-kit-skills
  15. ```
  16. Or run it yourself:
  17. ```sh
  18. ask-kit kit install temet-ai/ask-kit-skills # shows what it reads, changes and runs
  19. ask-kit kit install temet-ai/ask-kit-skills --yes # installs and enables it
  20. ```
  21. Restart your agents so `ask` lists `skills`. Project skills and agents come from the repository
  22. your agent works in; a question that names another folder is answered for that folder.
  23. ## What it carries
  24. | | |
  25. |---|---|
  26. | Scripts | `covers` (which skill or agent fits a job, plus marketplace plugins that match), `says` (the sections of a skill or agent about a topic, with `path:line`), `inventory` (what is installed, from where, plugin versions, marketplace search), `mentions` (every skill and agent that names a string), `lint` (frontmatter and description problems), `evaluate` (one skill folder against the checks a skill needs before it ships: description with what, when and trigger phrases, SKILL.md length, reference links and files, script permissions, placeholder text, each finding with file and line), `overlaps` (duplicates and near-duplicates) |
  27. | Skills | `write-skill`, `scaffold-skill` (the questions to settle before a new skill folder is written, and the scaffold call), `write-agent`, `fix-description`, `merge`, `retire`, `stale-sweep`: playbooks the investigator loads when the job calls for one |
  28. | Roles | `author` for requests to create or change a skill or agent; `auditor` for questions about validity, overlap and staleness |
  29. It reads `~/.claude/skills`, `~/.claude/agents`, `~/.claude/commands`, the repository's `.claude`
  30. folders, the plugins in `~/.claude/plugins/installed_plugins.json` (only the installed version of
  31. each) and the skills synced from claude.ai. It reads nothing else under `~/.claude`, and refuses
  32. files whose names look like credentials.
  33. Each script also runs with no model: `ask-kit run skills lint origin=user`, or
  34. `ask(do: "skills.lint")` from an agent.
  35. What `lint` checks was taken from the Claude Code documentation and checked against
  36. `claude plugin validate`: a frontmatter that does not parse (an unclosed quote, a tab in a block),
  37. a missing or glued closing `---`, no name or description, unknown or misspelled fields, tools an
  38. agent names that do not exist, a bad model, effort or colour, a description with no cue for when to
  39. use it or over the 1,536-character listing cap, a SKILL.md over 500 lines, broken links to files
  40. beside it, files beside it that nothing links to, scripts that are not executable, placeholder text left in the body. Settings, hooks, CLAUDE.md, rules and memory are not searched.
  41. ## What it can change
  42. When the request asks for a change, it creates, edits, renames and retires skill and agent files:
  43. `claude.create`, `claude.scaffold`, `claude.write`, `claude.edit`, `claude.setField`,
  44. `claude.rename`, `claude.retire`. A question never changes anything: each of those throws unless the caller asked
  45. for a change (`act`).
  46. - It writes only inside `~/.claude/skills`, `agents` and `commands` and the repository's
  47. `.claude/skills`, `agents` and `commands`. A plugin's copy and a synced claude.ai skill are
  48. refused, and so is any text that looks like a key or token.
  49. - `claude.scaffold(spec)` writes a whole skill folder from a spec (name, description, purpose, sections,
  50. reference files, scripts): SKILL.md with the spec's content, each reference file and script, scripts
  51. made executable. It refuses an existing folder and a spec with a gap or placeholder text.
  52. - Every change returns the lint of the file it wrote.
  53. - Retiring moves the file to `~/.claude/retired/` and returns the command that moves it back.
  54. Nothing is deleted.
  55. ## How well it works
  56. `bench/questions.json` holds six questions and three script runs, put to the folder `bench/fixtures/watch`, each with patterns
  57. its answer must hold. It has not been run on a model yet; `ask-kit kit test skills` runs it.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.