{"id":51611437,"url":"https://github.com/kev365/xways-xtension-builder-skill","last_synced_at":"2026-07-12T08:30:26.536Z","repository":{"id":369207614,"uuid":"1262342710","full_name":"kev365/xways-xtension-builder-skill","owner":"kev365","description":"Claude Code skill + knowledge base for authoring X-Ways Forensics X-Tensions (unofficial community project).","archived":false,"fork":false,"pushed_at":"2026-07-04T04:44:21.000Z","size":340,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-04T06:24:11.728Z","etag":null,"topics":["agent-skill","claude-code","claude-skill","cybersecurity","dfir","digital-forensics","forensics","forensics-investigations","forensics-tools","x-tension","x-ways","x-ways-forensics","xways"],"latest_commit_sha":null,"homepage":"","language":"C++","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/kev365.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-07T22:04:23.000Z","updated_at":"2026-07-04T05:44:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kev365/xways-xtension-builder-skill","commit_stats":null,"previous_names":["kev365/xways-xtension-builder-skill"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/kev365/xways-xtension-builder-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kev365%2Fxways-xtension-builder-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kev365%2Fxways-xtension-builder-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kev365%2Fxways-xtension-builder-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kev365%2Fxways-xtension-builder-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kev365","download_url":"https://codeload.github.com/kev365/xways-xtension-builder-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kev365%2Fxways-xtension-builder-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35387180,"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-07-12T02:00:06.386Z","response_time":87,"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-skill","claude-code","claude-skill","cybersecurity","dfir","digital-forensics","forensics","forensics-investigations","forensics-tools","x-tension","x-ways","x-ways-forensics","xways"],"created_at":"2026-07-12T08:30:25.860Z","updated_at":"2026-07-12T08:30:26.530Z","avatar_url":"https://github.com/kev365.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# X-Ways X-Tension Builder Skill\n\n[![CI](https://github.com/kev365/xways-xtension-builder-skill/actions/workflows/ci.yml/badge.svg)](https://github.com/kev365/xways-xtension-builder-skill/actions/workflows/ci.yml)\n\nA [Claude Code](https://claude.com/claude-code) **skill** and **knowledge base**\nfor authoring [X-Ways Forensics](https://www.x-ways.net/forensics/)\n**X-Tensions** — the `xways-\u003cname\u003e.dll` plugins that extend X-Ways (wrap external\nforensic tools, parse artifacts natively, drive the Events Viewer / Directory\nBrowser).\n\nIt gives Claude the X-Ways-specific *how*: pick a template, scaffold + rename +\nset identity, wire in the project conventions (helper-exe verification,\nCtrl-to-save, output directory, subprocess stdio, manager compatibility), and\nverify every `XWF_*` API call against distilled, citable reference notes so\ngenerated code never invents API.\n\n\u003e **Unofficial / community project.** Not affiliated with, endorsed by, or\n\u003e supported by X-Ways Software Technology AG. Provided as-is under the MIT\n\u003e License. \"X-Ways\", \"X-Ways Forensics\", and \"WinHex\" are trademarks of\n\u003e X-Ways AG.\n\n## What's inside\n\n| Path | What's there |\n| --- | --- |\n| [`.claude/skills/xways-xtension-authoring/`](.claude/skills/xways-xtension-authoring/) | The skill — `SKILL.md` flow router, reference guides, and PowerShell scaffold/build/hygiene scripts |\n| `.claude/commands/xtension.md` | The `/xtension` slash command |\n| [`templates/x-tensions/`](templates/x-tensions/) | Starter templates: `cpp`, `cpp-xtmgr-compatible`, `python`, and a rich CLI-wrapper `wrapper` template |\n| [`docs/`](docs/INDEX.md) | Distilled X-Tension API reference notes + the [convention library](docs/conventions/index.md) |\n| [`CHANGELOG.md`](CHANGELOG.md) | Release history + known issues queued for the next release |\n\n## Install (as a Claude Code plugin)\n\n```text\n/plugin marketplace add kev365/xways-xtension-builder-skill\n/plugin install xways-xtension-authoring@xways-xtension-builder\n```\n\nThen ask Claude to \"scaffold a new X-Tension\", \"wrap `\u003ctool\u003e` in an X-Tension\",\nor run `/xtension new \u003cname\u003e`. The skill also auto-triggers on those phrases.\n\n**Two ways to use it:**\n\n- **Installed as a plugin** (above) — you get the skill's *guidance* and the\n  `/xtension` command in any project. Best for \"wrap this tool\" / \"audit my\n  X-Tension\" conversations.\n- **Cloned and opened in Claude Code** — the skill auto-loads from\n  `.claude/skills/`, and the **scaffold/build scripts run against the cloned\n  working copy** (they create `x-tensions/\u003cname\u003e/` in the clone and build there).\n  This is the path for actually *authoring* an X-Tension with the bundled scripts\n  and templates.\n\n## Quickstart\n\nAfter installing, scaffold and build your first X-Tension — conversationally, or\ndrive the scripts directly:\n\n- **Conversationally:** ask Claude *\"scaffold a new X-Tension that wraps `\u003ctool\u003e`\"*,\n  or run `/xtension new myscanner`.\n- **Scripts** (when you've cloned the repo), from the repo root in PowerShell:\n\n  ```powershell\n  # Scaffold from the CLI-wrapper template (dry-run first to preview the plan)\n  .claude/skills/xways-xtension-authoring/scripts/new-xtension.ps1 -Name myscanner -Template wrapper -DryRun\n  .claude/skills/xways-xtension-authoring/scripts/new-xtension.ps1 -Name myscanner -Template wrapper\n\n  # Fill in your tool's command + result parsing (see the // TODO markers in\n  # x-tensions/xways-myscanner/), then build + deploy into your X-Ways install:\n  .claude/skills/xways-xtension-authoring/scripts/build-xtension.ps1 -Name xways-myscanner -DeployRoot \"\u003cyour X-Ways install\u003e\"\n  ```\n\nSee [Prerequisites](#prerequisites) for the build toolchain and SDK.\n\n## Prerequisites\n\n- **X-Ways Forensics 21.x+** (Windows x64) to run the X-Tensions you build.\n- **MSVC (x64)** — the \"x64 Native Tools Command Prompt for VS 2022\" (VS 2019\n  Build Tools also work; `build.bat` auto-bootstraps either) — to compile.\n- **The X-Ways X-Tension SDK** (the `X-Tension.h` header) to build C++\n  X-Tensions. This repo does **not** ship the SDK — it is copyright X-Ways AG.\n  See [docs/getting-the-sdk.md](docs/getting-the-sdk.md) to acquire your own copy.\n\n## Usage\n\n```powershell\n# Scaffold (dry-run first to review the planned copies / renames / edits)\n.claude/skills/xways-xtension-authoring/scripts/new-xtension.ps1 -Name \u003cname\u003e -Template wrapper -DryRun\n\n# Build (close X-Ways first — the DLL is locked while it runs; no hot reload)\n.claude/skills/xways-xtension-authoring/scripts/build-xtension.ps1 -Name xways-\u003cname\u003e\n```\n\nSee the [knowledge base](docs/INDEX.md), the\n[convention library](docs/conventions/index.md), and the\n[API guardrail](.claude/skills/xways-xtension-authoring/references/api-guardrail.md).\n\n## Contributing, sharing \u0026 feedback\n\nThis is a community project and **feedback is genuinely wanted**:\n\n- **Built an X-Tension with this skill? Share it.** The canonical home for\n  community X-Tensions is X-Ways' own\n  [third-party X-Tensions list](https://www.x-ways.net/forensics/x-tensions.html) —\n  contact X-Ways to get yours listed (their\n  [X-Tension page](https://www.x-ways.net/forensics/x-tensions/api.html) has the\n  submission details). You're also welcome to link your repo in an issue so it can\n  join [docs/exemplars.md](docs/exemplars.md) and feed patterns back into the templates.\n- **Ideas to improve the skill, templates, or docs?** Open an issue. Corrections\n  to the API notes are especially valuable.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) and [SECURITY.md](SECURITY.md).\n\n## License \u0026 attribution\n\nMIT — see [LICENSE](LICENSE). The API reference notes are distilled, paraphrased,\nor empirically derived; the X-Ways SDK, manuals, and user-forum content are\n**not** redistributed here. Credits to X-Ways AG, `xwf-api-rs`, and community\nX-Tension authors are in [NOTICE](NOTICE).\n\n## A note on how this was made\n\nThis skill and knowledge base were **generated with the help of an AI agent\n(Claude)**, drawn from notes, experiments, and conventions collected while\nbuilding X-Tensions for X-Ways Forensics. The material has been reviewed, but\nmistakes and out-of-date details are inevitable — **corrections, clarifications,\nand better information are very welcome.** Please open an issue or PR.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkev365%2Fxways-xtension-builder-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkev365%2Fxways-xtension-builder-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkev365%2Fxways-xtension-builder-skill/lists"}