yfe404/frida-17-skill/frida-17-skill

Claude Code and agent skill by yfe404/frida-17-skill

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Frida 17 JavaScript API compatibility checker and fixer. Use when writing, reviewing, or fixing Frida scripts, especially when migrating from older Frida versions. Detects deprecated APIs removed in Frida 17 (May 2025) and provides correct replacements. Covers Module, Memory, Process APIs and common naming conflicts.

Install

npx vskill@latest install yfe404/frida-17-skill/frida-17-skill

SKILL.md

Frida 17 Scripting Guide

This skill helps write and fix Frida scripts compatible with Frida 17.0.0 (released May 2025).

Breaking Changes in Frida 17

1. Static Module Methods - REMOVED
javascript
// OLD - No longer works in Frida 17
Module.findBaseAddress('libriver.so')
Module.getBaseAddress('libriver.so')
Module.findExportByName(null, 'open')
Module.findExportByName('libc.so', 'open')
Module.getExportByName(null, 'open')
Module.ensureInitialized('libc.so')
Module.enumerateExports('libc.so')
Module.enumerateSymbols('libc.so')
// NEW - Use Process and instance methods instead
var lib = Process.findModuleByName('libriver.so');  // returns Module or null
var lib = Process.getModuleByName('libriver.so');   // throws if not found
lib.base                                             // module base address
lib.findExportByName('open')                        // returns address or null
lib.getExportByName('open')                         // throws if not found
lib.enumerateExports()                              // returns array
lib.enumerateSymbols()                              // returns array
2. Static Memory Methods - REMOVED
javascript
// OLD - No longer works
Memory.readU32(ptr)
Memory.writeU32(ptr, value)
// NEW - Use NativePointer instance methods
ptr.readU32()
ptr.writeU32(value)
3. Legacy Enumeration APIs - REMOVED
javascript
// OLD - Callback style removed
Process.enumerateModules({ onMatch: fn, onComplete: fn })
Process.enumerateModulesSync()
// NEW - Returns array directly
Process.enumerateModules()
4. Reserved Function Names - DO NOT OVERRIDE

The following are built-in Frida functions. Defining custom functions with these names causes: TypeError: cannot define variable 'hexdump'

Reserved names:

  • hexdump - Use dumpHex instead for custom hex dump functions
  • ptr - pointer constructor shorthand
  • NULL - null pointer constant
javascript
// BAD - conflicts with built-in
function hexdump(ptr, len) { ... }
// GOOD - use different name
function dumpHex(ptr, len) { ... }

NativePointer Methods (Valid in Frida 17)

Conversion:

  • toInt32() - cast to signed 32-bit integer
  • toNumber() - convert to JavaScript number
  • toString([radix]) - convert to string

NOT available:

  • toUInt32() - DOES NOT EXIST, use toInt32() for sizes < 2^31

Memory reading:

  • readU8(), readS8(), readU16(), readS16()
  • readU32(), readS32(), readU64(), readS64()
  • readByteArray(length) - returns ArrayBuffer
  • readPointer(), readCString(), readUtf8String()

Memory writing:

  • writeU8(value), writeS8(value), etc.
  • writeByteArray(bytes) - bytes must be ArrayBuffer or JS array
  • writePointer(ptr), writeUtf8String(str)

Pointer arithmetic:

  • add(rhs), sub(rhs), and(rhs), or(rhs), xor(rhs)
  • shr(n), shl(n), not()
  • isNull(), equals(rhs), compare(rhs)

Java Bridge API (Unchanged in Frida 17)

javascript
Java.perform(function() {
    var MyClass = Java.use('com.example.MyClass');
    // Hook with overload
    MyClass.myMethod.overload('int', 'java.lang.String').implementation = function(a, b) {
        console.log('Called with: ' + a + ', ' + b);
        // Call original
        return this.myMethod.overload('int', 'java.lang.String').call(this, a, b);
    };
    // Hook all overloads
    MyClass.myMethod.overloads.forEach(function(overload) {
        overload.implementation = function() {
            return overload.apply(this, arguments);
        };
    });
});

Java byte[] handling: Java byte arrays cannot be passed directly to Memory.alloc().writeByteArray(). Convert manually:

javascript
// BAD - throws "expected a buffer-like object"
var hex = dumpHex(Memory.alloc(javaByteArray.length).writeByteArray(javaByteArray), len);
// GOOD - iterate and convert
var hex = "";
for (var i = 0; i < javaByteArray.length; i++) {
    hex += ("0" + (javaByteArray[i] & 0xff).toString(16)).slice(-2);
}

Common Patterns for Frida 17

Waiting for a library to load
javascript
function waitForLibrary(libName, callback) {
    var lib = Process.findModuleByName(libName);
    if (lib) {
        callback(lib.base);
        return;
    }
    var pollInterval = setInterval(function() {
        var lib = Process.findModuleByName(libName);
        if (lib) {
            clearInterval(pollInterval);
            callback(lib.base);
        }
    }, 500);
}
Hooking libc functions
javascript
var libc = Process.findModuleByName('libc.so');
var open = libc ? libc.findExportByName('open') : null;
if (open) {
    Interceptor.attach(open, {
        onEnter: function(args) {
            console.log('open(' + args[0].readCString() + ')');
        }
    });
}
Custom hex dump function
javascript
function dumpHex(ptr, len) {
    if (!ptr || ptr.isNull()) return 'null';
    try {
        var bytes = ptr.readByteArray(len);
        if (!bytes) return 'null';
        var arr = new Uint8Array(bytes);
        var hex = '';
        for (var i = 0; i < arr.length; i++) {
            hex += ('0' + arr[i].toString(16)).slice(-2);
        }
        return hex;
    } catch (e) {
        return 'error: ' + e;
    }
}

Checklist for Frida 17 Compatibility

When reviewing a Frida script, check for:

  1. [ ] Module.findBaseAddress() -> Process.findModuleByName().base
  2. [ ] Module.getBaseAddress() -> Process.getModuleByName().base
  3. [ ] Module.findExportByName(null, name) -> Process.findModuleByName('libc.so').findExportByName(name)
  4. [ ] Module.findExportByName(lib, name) -> Process.findModuleByName(lib).findExportByName(name)
  5. [ ] Module.enumerateExports(lib) -> Process.getModuleByName(lib).enumerateExports()
  6. [ ] Module.enumerateSymbols(lib) -> Process.getModuleByName(lib).enumerateSymbols()
  7. [ ] Memory.readU32(ptr) -> ptr.readU32()
  8. [ ] toUInt32() -> toInt32() (toUInt32 never existed)
  9. [ ] function hexdump() -> function dumpHex() (name conflict)
  10. [ ] Java byte[] with writeByteArray() -> manual hex conversion

References

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationWarning, 77 of 100Marginal. 1 run. Evaluated 8 months ago.

See evaluation results

Source

  • SKILL.md in the repositoryCheckingSKILL.md

Popularity

Repository forks
1
7-day trend score
0

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 19 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/yfe404/frida-17-skill/frida-17-skill/badge)](https://verified-skill.com/skills/yfe404/frida-17-skill/frida-17-skill)

Something wrong with this skill or its page? Tell us.