How do I install the Converting Minikit To Farcaster skill?

Run npx skillmds@latest add jiayaoqijia/converting-minikit-to-farcaster in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Converting Minikit To Farcaster safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Converting Minikit To Farcaster?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Converting Minikit To Farcaster free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Converting Minikit To Farcaster?

jiayaoqijia (@jiayaoqijia) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Converting Minikit To Farcaster by jiayaoqijia

Name: Converting Minikit To Farcaster
Author: jiayaoqijia

Converting Minikit To Farcaster

Converts Mini Apps from MiniKit (OnchainKit) to native Farcaster SDK. Use when migrating from @coinbase/onchainkit/minikit, converting MiniKit hooks, removing MiniKitProvider, or when user mentions MiniKit, OnchainKit, or Farcaster SDK migration.

jiayaoqijia Updated Sep 17, 2026

File contents

MiniKit to Farcaster SDK

Breaking Changes (SDK v0.2.0+)

sdk.context is a Promise — must await
sdk.isInMiniApp() accepts no parameters
sdk.actions.setPrimaryButton() has no onClick callback

Check version: npm list @farcaster/miniapp-sdk

Quick Reference

MiniKit	Farcaster SDK	Notes
`useMiniKit().setFrameReady()`	`await sdk.actions.ready()`
`useMiniKit().context`	`await sdk.context`	Async
`useMiniKit().isSDKLoaded`	`await sdk.isInMiniApp()`	No params
`useClose()`	`await sdk.actions.close()`
`useOpenUrl(url)`	`await sdk.actions.openUrl(url)`
`useViewProfile(fid)`	`await sdk.actions.viewProfile({ fid })`
`useViewCast(hash)`	`await sdk.actions.viewCast({ hash })`
`useComposeCast()`	`await sdk.actions.composeCast({ text, embeds })`
`useAddFrame()`	`await sdk.actions.addMiniApp()`
`usePrimaryButton(opts, cb)`	`await sdk.actions.setPrimaryButton(opts)`	No callback
`useAuthenticate()`	`sdk.quickAuth.getToken()`	See AUTH.md

Context Access Pattern

// WRONG
const fid = sdk.context?.user?.fid;

// CORRECT
const context = await sdk.context;
const fid = context?.user?.fid;

In React components, use state:

const [context, setContext] = useState(null);

useEffect(() => {
  const load = async () => {
    const ctx = await sdk.context;
    setContext(ctx);
  };
  load();
}, []);

Conversion Workflow

Verify Node.js >= 22.11.0
Update dependencies — see DEPENDENCIES.md
Replace imports: @coinbase/onchainkit/minikit → @farcaster/miniapp-sdk
Convert hooks using reference above
Add FrameProvider — see PROVIDER.md
Update manifest: frame → miniapp — see MANIFEST.md

Common Errors

"Property 'user' does not exist on type 'Promise'" → Await sdk.context before accessing properties

"Expected 0 arguments, but got 1" → Remove parameters from sdk.isInMiniApp()

Context is null in components → Ensure FrameProvider is in your provider chain

References

MAPPING.md — Complete hook-by-hook conversion reference
EXAMPLES.md — Before/after code examples
PROVIDER.md — Provider setup with FrameProvider
PITFALLS.md — Common errors and solutions
DEPENDENCIES.md — Package updates
AUTH.md — Quick Auth migration
MANIFEST.md — farcaster.json changes

---name: converting-minikit-to-farcasterdescription: Converts Mini Apps from MiniKit (OnchainKit) to native Farcaster SDK. Use when migrating from @coinbase/onchainkit/minikit, converting MiniKit hooks, removing MiniKitProvider, or when user mentions MiniKit, OnchainKit, or Farcaster SDK migration.---# MiniKit to Farcaster SDK## Breaking Changes (SDK v0.2.0+)1. `sdk.context` is a **Promise** — must await2. `sdk.isInMiniApp()` accepts **no parameters**3. `sdk.actions.setPrimaryButton()` has no onClick callbackCheck version: `npm list @farcaster/miniapp-sdk`## Quick Reference| MiniKit | Farcaster SDK | Notes ||---------|---------------|-------|| `useMiniKit().setFrameReady()` | `await sdk.actions.ready()` | || `useMiniKit().context` | `await sdk.context` | **Async** || `useMiniKit().isSDKLoaded` | `await sdk.isInMiniApp()` | No params || `useClose()` | `await sdk.actions.close()` | || `useOpenUrl(url)` | `await sdk.actions.openUrl(url)` | || `useViewProfile(fid)` | `await sdk.actions.viewProfile({ fid })` | || `useViewCast(hash)` | `await sdk.actions.viewCast({ hash })` | || `useComposeCast()` | `await sdk.actions.composeCast({ text, embeds })` | || `useAddFrame()` | `await sdk.actions.addMiniApp()` | || `usePrimaryButton(opts, cb)` | `await sdk.actions.setPrimaryButton(opts)` | No callback || `useAuthenticate()` | `sdk.quickAuth.getToken()` | See [AUTH.md](AUTH.md) |## Context Access Pattern```typescript// WRONGconst fid = sdk.context?.user?.fid;// CORRECTconst context = await sdk.context;const fid = context?.user?.fid;```In React components, use state:```typescriptconst [context, setContext] = useState(null);useEffect(() => { const load = async () => { const ctx = await sdk.context; setContext(ctx); }; load();}, []);```## Conversion Workflow1. Verify Node.js >= 22.11.02. Update dependencies — see [DEPENDENCIES.md](DEPENDENCIES.md)3. Replace imports: `@coinbase/onchainkit/minikit` → `@farcaster/miniapp-sdk`4. Convert hooks using reference above5. Add FrameProvider — see [PROVIDER.md](PROVIDER.md)6. Update manifest: `frame` → `miniapp` — see [MANIFEST.md](MANIFEST.md)## Common Errors**"Property 'user' does not exist on type 'Promise<MiniAppContext>'"**→ Await `sdk.context` before accessing properties**"Expected 0 arguments, but got 1"**→ Remove parameters from `sdk.isInMiniApp()`**Context is null in components**→ Ensure FrameProvider is in your provider chain## References- [MAPPING.md](MAPPING.md) — Complete hook-by-hook conversion reference- [EXAMPLES.md](EXAMPLES.md) — Before/after code examples- [PROVIDER.md](PROVIDER.md) — Provider setup with FrameProvider- [PITFALLS.md](PITFALLS.md) — Common errors and solutions- [DEPENDENCIES.md](DEPENDENCIES.md) — Package updates- [AUTH.md](AUTH.md) — Quick Auth migration- [MANIFEST.md](MANIFEST.md) — farcaster.json changes

Frequently asked questions