{"id":50802469,"url":"https://github.com/lumpinif/steal-the-code","last_synced_at":"2026-06-12T21:33:17.021Z","repository":{"id":362291522,"uuid":"1258269745","full_name":"lumpinif/steal-the-code","owner":"lumpinif","description":"Make coding agents study open-source precedents before they build.","archived":false,"fork":false,"pushed_at":"2026-06-03T13:22:55.000Z","size":3855,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-03T14:17:00.818Z","etag":null,"topics":["agent-skills","agentic-coding","ai-agents","ai-coding","claude-code","codex","coding-agents","cursor","developer-tools","open-source","skill","workflow-automation"],"latest_commit_sha":null,"homepage":"https://lumpinif.github.io/steal-the-code/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lumpinif.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-03T12:27:57.000Z","updated_at":"2026-06-03T13:22:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/lumpinif/steal-the-code","commit_stats":null,"previous_names":["lumpinif/steal-the-code"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/lumpinif/steal-the-code","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lumpinif%2Fsteal-the-code","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lumpinif%2Fsteal-the-code/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lumpinif%2Fsteal-the-code/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lumpinif%2Fsteal-the-code/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lumpinif","download_url":"https://codeload.github.com/lumpinif/steal-the-code/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lumpinif%2Fsteal-the-code/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34263872,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","agentic-coding","ai-agents","ai-coding","claude-code","codex","coding-agents","cursor","developer-tools","open-source","skill","workflow-automation"],"created_at":"2026-06-12T21:33:14.485Z","updated_at":"2026-06-12T21:33:17.012Z","avatar_url":"https://github.com/lumpinif.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Steal the Code\n\n[![skills.sh](https://skills.sh/b/lumpinif/steal-the-code)](https://skills.sh/lumpinif/steal-the-code)\n\n## Moved to Find OSS Alternative\n\nThis project is now legacy and may no longer receive active updates.\n\nUse the maintained skill instead:\n\n```bash\nnpx skills add lumpinif/find-oss-alternative\n```\n\nUse without installing:\n\n```bash\nnpx skills use lumpinif/find-oss-alternative@find-oss-alternative\n```\n\nRepository: [lumpinif/find-oss-alternative](https://github.com/lumpinif/find-oss-alternative)\n\n---\n\nAsk your agent to steal the code first, then build something better.\n\nSteal the Code is a skill for agentic coding. Before an agent designs or builds\na product, feature, module, system, or another skill, it finds real public\nopen-source precedents, studies what works, and turns that evidence into a\npractical implementation plan.\n\nThis is not about stealing private code or ignoring licenses. It is about making\nagents learn from public builders instead of inventing worse versions of things\nthat already exist.\n\n## Why You Need It\n\n- **Problem**: agents can code well, but still make weak product, architecture,\n  and workflow decisions.\n- **Missing context**: the agent only sees your prompt and current codebase,\n  while the best public precedents are scattered across repos, skills, docs,\n  launches, and community threads.\n- **Fix**: make the agent study those precedents before it builds.\n- **Result**: better product instincts, cleaner architecture, proven patterns,\n  clear things to avoid, and a higher chance of building something better.\n\n## Install\n\n```bash\nnpx skills add lumpinif/steal-the-code\n```\n\nUse without installing:\n\n```bash\nnpx skills use lumpinif/steal-the-code@steal-the-code\n```\n\n## What It Does\n\nSteal the Code is a precedent pipeline for coding agents.\n\n1. **Decompose the idea**  \n   Turns a vague request into product, workflow, architecture, implementation,\n   analogy, and negative keywords. This prevents the agent from searching one\n   weak phrase and missing the real category.\n\n2. **Mine real-world language**  \n   Uses skills, GitHub, Hacker News, docs, and public web signals to learn how\n   builders and users describe similar problems.\n\n3. **Find public precedents**  \n   Uses no-login tools first: open-source alternative directories for seed\n   candidates, GitHub public repo search for repositories, Sourcegraph public\n   search for code-level evidence, HN Algolia for community signals, and\n   skills.sh for existing agent workflows.\n\n4. **Rank by practical fit**  \n   Re-ranks candidates with BM25-style local keyword matching and evidence\n   review. Fit to the user's workflow and implementation shape matters more\n   than stars.\n\n5. **Deep-read the winners**  \n   Reads the best repos with README/docs, raw GitHub files, Repomix, DeepWiki,\n   or local code search to understand what the project is really doing.\n\n6. **Turn evidence into a build decision**  \n   Produces `Use / Borrow / Avoid / Build New`, credits and license notes, and\n   concrete constraints for the next coding step. Optional outputs include an\n   HTML dashboard, a short precedent reel, and candidate JSON.\n\n## Optional Outputs\n\nThe default output is a concise chat brief. When the result is worth sharing or\nhanding off to another agent, Steal the Code can also produce richer artifacts.\n\n- **HTML Dashboard**: a single local HTML file that compares candidates by fit,\n  source, license, platform, takeaways, and `Use / Borrow / Avoid / Build New`.\n  Use this when you want a durable visual brief for yourself, a team, or another\n  agent.\n- **Precedent Reel**: a short HyperFrames or Remotion video that turns the same\n  report into a shareable walkthrough. The agent chooses HyperFrames for fast\n  HTML-first reels and Remotion for React-first reusable video systems.\n- **Candidate JSON**: the source of truth for the brief, dashboard, and reel, so\n  later agents can continue from the same evidence instead of rerunning the\n  research from scratch.\n\n## Core Principle\n\nSteal ideas. Credit builders. Respect licenses. Build better.\n\n## Example Showcase\n\nThe Typeless alternative example can be turned into a visual report and a short\nvideo.\n\n- [Open the Typeless HTML Dashboard](https://lumpinif.github.io/steal-the-code/typeless-report.html)\n- [Open the Examples Page](https://lumpinif.github.io/steal-the-code/)\n\n[![Typeless precedent reel](assets/typeless-precedent-reel-contact-sheet.png)](assets/typeless-precedent-reel.mp4)\n\nClick the preview to open the MP4. GitHub README files do not reliably render\nrepo-hosted videos inline, so the screenshot acts as a stable preview.\n\n## Example\n\nIntent:\n\n```text\nBuild a free, open-source Typeless alternative.\n```\n\nProduct reference:\n\n- [Typeless](https://www.typeless.com/)\n\nThe skill expands the idea into query families:\n\n```text\nAI dictation\nvoice input in any app\nhold hotkey, speak, release\npolished text\nWhisper / local ASR\nLLM cleanup\npersonal dictionary\napp-specific prompt routing\nno subscription\n```\n\nIt finds projects such as:\n\n- [Open-Less/openless](https://github.com/Open-Less/openless)\n- [TypeWhisper/typewhisper-mac](https://github.com/TypeWhisper/typewhisper-mac)\n- [hehehai/voxt](https://github.com/hehehai/voxt)\n- [never13254/GhostType](https://github.com/never13254/GhostType)\n- [DoodzProg/AcouZ](https://github.com/DoodzProg/AcouZ)\n\nThen it turns the precedent set into a coding recommendation:\n\n- Use [OpenLess](https://github.com/Open-Less/openless) as the closest\n  full-product reference.\n- Borrow [TypeWhisper](https://github.com/TypeWhisper/typewhisper-mac)'s local\n  engine/plugin direction.\n- Borrow [Voxt](https://github.com/hehehai/voxt) and\n  [GhostType](https://github.com/never13254/GhostType)'s app-aware prompt\n  routing.\n- Reference [AcouZ](https://github.com/DoodzProg/AcouZ) for a minimal Windows\n  path.\n- Avoid building only a Whisper wrapper.\n- Build new only with a clear differentiated focus.\n\n## No-Login Default Toolchain\n\nThe default workflow prefers tools that an agent can run without user login or\nAPI keys:\n\n- GitHub public repository search\n- GitHub public contents/raw APIs\n- Public open-source alternative directories\n- Hacker News Algolia API\n- Sourcegraph public Stream API\n- Repomix\n- DeepWiki MCP when available\n- Local BM25-style candidate ranking\n\nAPI-key tools such as Exa, Tavily, Firecrawl, and Reposeek can be used as\nenhancements, but they are not required.\n\n## Scripts\n\nThe scripts are dependency-free Node.js tools for agents.\n\n```bash\nnode scripts/oss-directory-search.mjs \"notion\" --limit 10\nnode scripts/github-repo-search.mjs \"open source typeless alternative AI dictation\" --limit 10\nnode scripts/hn-search.mjs \"Typeless open source dictation\" --limit 10\nnode scripts/sourcegraph-search.mjs '\"global hotkey\" \"transcribe\" \"paste\" lang:Swift count:20'\nnode scripts/rank-candidates.mjs --query \"free open source typeless alternative AI dictation\" --input examples/typeless-candidates.json --fetch-readme\nnode scripts/render-html-report.mjs --input examples/typeless-report.json --out outputs/typeless-report.html\n```\n\nDirectory results are seed leads, not proof. Before using a candidate, verify\nits GitHub repository, license, maintenance recency, README/docs, and code-level\nevidence.\n\n## Responsible Use\n\nSteal the Code should always surface:\n\n- The source projects used.\n- The relevant license for each repo.\n- Whether direct code reuse is license-compatible.\n- What should be credited in docs, README, or release notes.\n- What should be borrowed as an idea instead of copied as code.\n\nIf an agent borrows code directly, it must preserve required attribution and\nfollow the license terms. If license compatibility is unclear, treat the project\nas inspiration only until a human verifies it.\n\n## Repository Layout\n\n```text\nSKILL.md\nreferences/\n  toolchain.md\n  output-modes.md\n  credits-and-licenses.md\ntemplates/\n  precedent-report.schema.json\nscripts/\n  oss-directory-search.mjs\n  github-repo-search.mjs\n  hn-search.mjs\n  sourcegraph-search.mjs\n  rank-candidates.mjs\n  render-html-report.mjs\nexamples/\n  typeless-candidates.json\n  typeless-report.json\ndocs/\n  index.html\n  typeless-report.html\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flumpinif%2Fsteal-the-code","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flumpinif%2Fsteal-the-code","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flumpinif%2Fsteal-the-code/lists"}