mrc4tt/CS2_VibeSignatures / .claude/skills/create-preprocessor-scripts
create-preprocessor-scripts
VerifiedCreate a new find-XXXX preprocessor Python script from scratch (no existing SKILL.md), add configs/<GAMEVER>.yaml skill and symbol entries. Covers xref-string-based and LLM_DECOMPILE-based discovery patterns. Use when a GitHub issue or user instruction specifies a new function to find.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 69.0 KB |
| agents/openai.yaml | config | 43 B |
| references/pattern-A.md | markdown | 3.2 KB |
| references/pattern-B.md | markdown | 3.5 KB |
| references/pattern-C.md | markdown | 4.5 KB |
| references/pattern-D.md | markdown | 2.0 KB |
| references/pattern-E.md | markdown | 4.1 KB |
| references/pattern-F.md | markdown | 6.7 KB |
| references/pattern-G.md | markdown | 3.0 KB |
| references/pattern-H.md | markdown | 3.7 KB |
| references/pattern-I.md | markdown | 8.7 KB |
| references/pattern-J.md | markdown | 5.2 KB |
| references/pattern-L.md | markdown | 8.4 KB |
| references/pattern-M.md | markdown | 11.9 KB |
references/pattern-A.md
View on GitHub# Pattern A -- Regular function via xref strings
**Use when:** function is non-virtual, discovered via debug string cross-references.
## Template
```python
#!/usr/bin/env python3
"""Preprocess script for find-{SKILL_NAME} skill."""
from ida_analyze_util import preprocess_common_skill
TARGET_FUNCTION_NAMES = [
"{FUNC_NAME}",
]
FUNC_XREFS = [
{
"func_name": "{FUNC_NAME}",
"xref_strings": [
"{XREF_STRING_1}", # Debug string from user input
],
"xref_gvs": [], # global variable names if needed, usually empty
"xref_signatures": [], # byte patterns if needed, usually empty
"xref_funcs": [], # known caller function names if needed
"exclude_funcs": [], # function names to exclude from results
"exclude_strings": [], # strings to exclude
"exclude_gvs": [], # global variable names to exclude
"exclude_signatures": [], # byte patterns to exclude
},
]
GENERATE_YAML_DESIRED_FIELDS = [
# (symbol_name, generate_yaml_fields)
(
"{FUNC_NAME}",
[
"func_name",
"func_sig",
"func_va",
"func_rva",
"func_size",
],
),
]
async def preprocess_skill(
session, skill_name, expected_outputs, old_yaml_map,
new_binary_dir, platform, image_base, debug=False,
):
"""Reuse previous gamever func_sig to locate target function(s) and write YAML."""
return await preprocess_common_skill(
session=session,
expected_outputs=expected_outputs,
old_yaml_map=old_yaml_map,
new_binary_dir=new_binary_dir,
platform=platform,
image_base=image_base,
func_names=TARGET_FUNCTION_NAMES,
func_xrefs=FUNC_XREFS,
generate_yaml_desired_fields=GENERATE_YAML_DESIRED_FIELDS,
debug=debug,
)
```
## Platform-Specific Xref Strings Variant
When xref strings differ between Windows and Linux, split into two variables:
```python
FUNC_XREFS_WINDOWS = [
{
"func_name": "{FUNC_NAME}",
"xref_strings": [
"CSource2GameEntities::CheckTransmit", # Full assertion string on Windows
],
"xref_gvs": [], "xref_signatures": [], "xref_funcs": [],
"exclude_funcs": [], "exclude_strings": [], "exclude_gvs": [], "exclude_signatures": [],
},
]
FUNC_XREFS_LINUX = [
{
"func_name": "{FUNC_NAME}",
"xref_strings": [
"./gameinterface.cpp:3", # Shorter path-based string on Linux
],
"xref_gvs": [], "xref_signatures": [], "xref_funcs": [],
"exclude_funcs": [], "exclude_strings": [], "exclude_gvs": [], "exclude_signatures": [],
},
]
```
Then in `preprocess_skill`, use a ternary to select the right one:
```python
func_xrefs=FUNC_XREFS_WINDOWS if platform == "windows" else FUNC_XREFS_LINUX,
```
This variant also applies to [Pattern B](pattern-B.md).
## Checklist
- [ ] `TARGET_FUNCTION_NAMES` lists all functions the script should find
- [ ] `FUNC_XREFS` xref strings match the user's specified debug strings
- [ ] `preprocess_common_skill` call passes `func_names=` and `func_xrefs=`
- [ ] No `FUNC_VTABLE_RELATIONS`, no `LLM_DECOMPILE`, no `llm_config` parameter
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 466k | Updated | Claude CodeCodex | Verified | Install |
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 466k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |