#737 by GitHub stars

kharmanskyi/open-steps

Plain-language agent skills for Claude Code, Codex, Cursor and Gemini CLI: honest session reports, straight verdicts, steps you can follow. MIT.

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

skills/os-ask-simple/SKILL.md

Week of Nov 2, 2026 · +0 / −0 lines

Before Instructions only → After Instructions only

4fa744ba8ea0 → 4fa744ba8ea0

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Instructions only

First observation → 4fa744ba8ea0

No earlier version was observed for comparison.

Compare on GitHub

skills/os-big-picture/SKILL.md

Week of Nov 2, 2026 · +0 / −0 lines

Before Network or broad shell → After Network or broad shell

4fa744ba8ea0 → 4fa744ba8ea0

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 4fa744ba8ea0

No earlier version was observed for comparison.

Compare on GitHub

skills/os-check-work/SKILL.md

Week of Nov 2, 2026 · +0 / −0 lines

Before Instructions only → After Instructions only

4fa744ba8ea0 → 4fa744ba8ea0

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Instructions only

First observation → 4fa744ba8ea0

No earlier version was observed for comparison.

Compare on GitHub

skills/os-done-or-not/SKILL.md

Week of Nov 2, 2026 · +0 / −0 lines

Before Network or broad shell → After Network or broad shell

4fa744ba8ea0 → 4fa744ba8ea0

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 4fa744ba8ea0

No earlier version was observed for comparison.

Compare on GitHub

skills/os-say-simple/SKILL.md

Week of Nov 2, 2026 · +0 / −0 lines

Before Network or broad shell → After Network or broad shell

4fa744ba8ea0 → 4fa744ba8ea0

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 4fa744ba8ea0

No earlier version was observed for comparison.

Compare on GitHub

skills/os-step-by-step/SKILL.md

Week of Nov 2, 2026 · +0 / −0 lines

Before Network or broad shell → After Network or broad shell

4fa744ba8ea0 → 4fa744ba8ea0

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 4fa744ba8ea0

No earlier version was observed for comparison.

Compare on GitHub

skills/os-what-could-go-wrong/SKILL.md

Week of Nov 2, 2026 · +0 / −0 lines

Before Network or broad shell → After Network or broad shell

4fa744ba8ea0 → 4fa744ba8ea0

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 4fa744ba8ea0

No earlier version was observed for comparison.

Compare on GitHub

skills/os-whats-next/SKILL.md

Week of Nov 2, 2026 · +0 / −0 lines

Before Network or broad shell → After Network or broad shell

4fa744ba8ea0 → 4fa744ba8ea0

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 4fa744ba8ea0

No earlier version was observed for comparison.

Compare on GitHub

View on GitHubAdd to my skills

Verified commit 4fa744ba8ea06ccf128a39853824c46ac391dd00

git clone --filter=blob:none --no-checkout https://github.com/kharmanskyi/open-steps.git .hotskills/kharmanskyi-open-steps && git -C .hotskills/kharmanskyi-open-steps checkout --detach 4fa744ba8ea06ccf128a39853824c46ac391dd00 # Copy each selected skill directory from .hotskills/kharmanskyi-open-steps into .claude/skills/<skill-name>/
1.3kGitHub stars
-12stars in 7 days
8skills in this repository
0commits in 30 days

Heat

0.1
  • Star growth, last 7 daysAhead of 1% of tracked repositories
  • Star growth, last 24 hoursAhead of 3% of tracked repositories
  • Rank movement, last 7 daysAhead of 2% of tracked repositories
  • Commits, last 30 daysAhead of 0% of tracked repositories
  • Accounts asking about it through MCP, last 7 daysNot available
  • Hot votes this weekAhead of 0% of tracked repositories

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

Aug 23, 2026Nov 6, 20261,294

Individual skills in this repository

How it works

os-ask-simple

When your agent uses it

ALWAYS invoke this skill before asking the user any technical question or offering options, and whenever they ask to be asked in plain words - "ask simple", "ask me simply", "ask me in plain words" - in any language. ALWAYS invoke it too when the user asks for your view on a technical choice: whether it is worth doing, more than the problem needs, or replaceable by something simpler, and which option you would take. Invoke it even when the code makes the answer look obvious: the checks are what make the answer more than a guess. Rewrites the question in plain words and always ends with one marked recommendation. A structural choice first passes six checks, shown as a table: effort now, simpler substitute, extra work later, lock-in, over-engineering, easy to undo. Doing nothing is always weighed.

What it loads into context

Frontmatter

214 tokens

Always available to the agent

SKILL.md

1,271 tokens

When the skill is activated

Reference documents

675 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

  1. Language
  2. When to use
  3. Before anything: is this even a question for them?
  4. Light form - every question
  5. Full form - six checks, for structural choices
  6. Hard rules
  7. Known gotchas

Files

  • ../../.claude-plugin/marketplace.jsonasset545 bytes
  • ../../.claude-plugin/plugin.jsonasset587 bytes
  • ../../hooks/hooks.jsonasset582 bytes
  • SKILL.mdcore5,435 bytes
  • references/01-sign-in-now-or-later.mddoc2,903 bytes
Read SKILL.md

# os-ask-simple

Two jobs. Ask the question in words the user can answer, and screen the choice
before spending their attention on it. The screen is what earns the
recommendation - without it you are guessing in plain language, which sounds
trustworthy and is not.

## Language

Write in the language the user speaks in this session. Detect it from the
conversation. Keep code, file names and identifiers in English.

## When to use
View the complete source on GitHub

Skills included

  • os-ask-simple
  • os-big-picture
  • os-check-work
  • os-done-or-not
  • os-say-simple
  • os-step-by-step
  • os-what-could-go-wrong
  • os-whats-next

Repository facts

License
MIT
Created
Aug 25, 2026
Last pushed
Oct 5, 2026
Forks
111
Open issues
5
Project activity
Active

Rank over the last 12 weeks

Now #737 · best #640 · down 13 in 30 days

  1. #718 on Nov 1
  2. #720 on Nov 2
  3. #724 on Nov 3
  4. #729 on Nov 4
  5. #733 on Nov 5
  6. #737 since Nov 6
61 earlier periods
  1. #924 on Aug 23
  2. #936 on Aug 25
  3. #920 on Aug 26
  4. #923 on Aug 27
  5. #958 on Aug 28
  6. #873 on Aug 29
  7. #876 on Aug 30
  8. #924 on Aug 31
  9. #958 on Sep 1
  10. #923 on Sep 2
  11. #928 on Sep 3
  12. #890 on Sep 4
  13. #865 on Sep 5
  14. #901 on Sep 6
  15. #925 on Sep 7
  16. #938 on Sep 8
  17. #922 on Sep 9
  18. #917 on Sep 10
  19. #879 on Sep 11
  20. #878 from Sep 12 to Sep 13
  21. #915 on Sep 14
  22. #902 on Sep 15
  23. #907 on Sep 16
  24. #899 on Sep 17
  25. #875 on Sep 18
  26. #835 on Sep 19
  27. #829 on Sep 20
  28. #826 on Sep 21
  29. #842 on Sep 22
  30. #816 on Sep 23
  31. #784 on Sep 24
  32. #748 on Sep 25
  33. #746 on Sep 26
  34. #761 on Sep 27
  35. #781 on Sep 28
  36. #792 on Sep 29
  37. #772 on Sep 30
  38. #710 on Oct 1
  39. #711 on Oct 2
  40. #682 on Oct 3
  41. #714 on Oct 5
  42. #719 on Oct 6
  43. #724 on Oct 7
  44. #748 on Oct 8
  45. #716 on Oct 9
  46. #700 on Oct 10
  47. #699 on Oct 11
  48. #715 on Oct 12
  49. #720 on Oct 13
  50. #719 on Oct 14
  51. #692 on Oct 15
  52. #677 on Oct 18
  53. #723 on Oct 20
  54. #728 on Oct 21
  55. #682 on Oct 23
  56. #640 on Oct 24
  57. #726 on Oct 25
  58. #717 on Oct 28
  59. #720 on Oct 29
  60. #711 on Oct 30
  61. #716 on Oct 31

Before you install

Network or broad shell

Automated signals, not a guarantee

Checked Nov 3, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 16 notes
  • skills/os-big-picture/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/os-big-picture/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/os-big-picture/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/os-big-picture/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/os-big-picture/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/os-done-or-not/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/os-say-simple/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/os-say-simple/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/os-say-simple/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/os-step-by-step/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/os-step-by-step/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/os-step-by-step/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/os-what-could-go-wrong/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/os-what-could-go-wrong/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/os-whats-next/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/os-whats-next/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
Show all 15 signals by file

.claude-plugin/marketplace.json

  • Network accessline 10
    "source": "./",       "description": "Plain-language skills for coding agents, for the person running development who does not read code: session reports, decisions, next steps and the whole picture.",       "homepage": "https://opensteps.a
  • Network accessline 11
    "description": "Plain-language skills for coding agents, for the person running development who does not read code: session reports, decisions, next steps and the whole picture.",       "homepage": "https://opensteps.ai",       "repository"
  • Network accessline 12
    "homepage": "https://opensteps.ai",
  • Network accessline 13
    "repository": "https://github.com/kharmanskyi/open-steps"

.claude-plugin/plugin.json

  • Network accessline 14
    "author": {     "name": "Pavlo Kharmanskyi",     "url": "https://github.com/kharmanskyi"
  • Network accessline 15
    "name": "Pavlo Kharmanskyi",     "url": "https://github.com/kharmanskyi"   },
  • Network accessline 16
    "url": "https://github.com/kharmanskyi"
  • Network accessline 17
    },   "homepage": "https://opensteps.ai",   "repository": "https://github.com/kharmanskyi/open-steps"
  • Network accessline 18
    "homepage": "https://opensteps.ai",
  • Network accessline 19
    "repository": "https://github.com/kharmanskyi/open-steps"

skills/os-big-picture/SKILL.md

  • Broad permissionsline 1
    Bash(bash ${CLAUDE_SKILL_DIR}/scripts/census.sh *)

skills/os-big-picture/scripts/census.sh

  • Executable scriptline 1
    #!/usr/bin/env bash
  • Executable scriptline 1
    #!/usr/bin/env bash

skills/os-what-could-go-wrong/SKILL.md

  • Broad permissionsline 1
    Bash(bash ${CLAUDE_SKILL_DIR}/scripts/prompt.sh)

skills/os-what-could-go-wrong/scripts/prompt.sh

  • Executable scriptline 1
    #!/usr/bin/env bash

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Some files could not be read; the facts below still hold.

No combined signals at this commit.

Works with

Agent compatibility, from the files in this repository
AgentStatusEvidenceInstall to
Claude CodeNativeManifest .claude-plugin/marketplace.json.claude/skills/<skill-name>/
CodexCompatibleStandard SKILL.md skills/os-ask-simple/SKILL.md.agents/skills/<skill-name>/
CursorCompatibleStandard SKILL.md skills/os-ask-simple/SKILL.md.cursor/skills/<skill-name>/
Gemini CLICompatibleStandard SKILL.md skills/os-ask-simple/SKILL.md.gemini/skills/<skill-name>/
GitHub CopilotCompatibleStandard SKILL.md skills/os-ask-simple/SKILL.md.github/skills/<skill-name>/
OpenCodeCompatibleStandard SKILL.md skills/os-ask-simple/SKILL.md.opencode/skills/<skill-name>/
  • Native The repository ships a manifest, folder or frontmatter field for this agent.
  • Compatible A standard SKILL.md that this agent can read.
  • Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.

Explore alternatives and comparisons

Add this badge to your README

It updates every night and links to this page.

kharmanskyi/open-steps: #737 on hotskills, 1.3k stars

[![kharmanskyi/open-steps on hotskills](https://hotskills.dev/badge/kharmanskyi-open-steps.svg)](https://hotskills.dev/skill/kharmanskyi-open-steps/)