explaingit

timmyonchain/skillsmith

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

A research agent for the Mantle blockchain that answers questions with existing skills and creates new reusable skills on the fly when none fit.

Mindmap

mindmap
  root((repo))
    What it does
      Answers Mantle questions
      Forges new skills on demand
      Reuses saved skills
    Tech stack
      Next.js
      TypeScript
      Supabase
      Gemini
    Use cases
      Ask Mantle network questions
      Analyze wallet holdings
      Query on chain data
    Audience
      Developers
      Researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Ask questions about Mantle network fundamentals like gas and finality.

USE CASE 2

Look up historical or analytical data through indexer queries.

USE CASE 3

Check a wallet's balances and DeFi positions read-only.

USE CASE 4

Watch the agent forge and save a brand new skill for an unanswered question.

What is it built with?

Next.jsTypeScriptTailwind CSSSupabaseviemGemini

How does it compare?

timmyonchain/skillsmith0xkinno/astraea0xkinno/halcyon
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a Supabase project and API keys for Gemini, OpenRouter, and Supabase before running.

No license information is provided in the README.

In plain English

Skillsmith is a research agent built for the Mantle blockchain network. It comes with a set of ready made skills for answering questions about Mantle, but its main idea is that it does not stop there. When a question arrives that none of its existing skills can answer, the agent creates a brand new skill on the spot, saves it, and reuses it the next time a similar question comes up. Over time the agent's set of abilities grows simply from being used. Every question the agent receives goes through three stages. First, a router looks at the question next to the current list of skills and picks the closest match, or decides nothing fits and flags it as new. Second, if a skill matches, it answers using its saved instructions, and for skills tied to on chain data it can also pull live information from the Mantle mainnet when a wallet address is given. Third, if no skill fits, the model designs a fresh mini skill, complete with a name, description, trigger words, and reusable instructions, answers the question with it, then stores it so related questions later match this new skill instead of triggering another forge. The interface is a two panel workbench: a chat window on one side and a live library of skills, called the rack, on the other. Newly created skills appear in the rack with a short animation. Three official skills come pre-loaded at setup: one covering basic Mantle concepts like gas and finality, one for historical and analytical queries, and one for read-only wallet analysis such as balances and DeFi positions. These are based on skills from a separate, real Mantle skills repository. Technically, the project is built with Next.js and TypeScript, styled with Tailwind CSS, and uses Google Gemini as its main language model with an OpenRouter fallback. It stores its skill library in Supabase and reads Mantle chain data using viem. Setup requires Node.js 18 or newer plus a Supabase project, along with API keys for Gemini, OpenRouter, and Supabase filled into an environment file, and a database migration applied before running the app locally. The project was built for Mantle's Research Challenge.

Copy-paste prompts

Prompt 1
Help me set up timmyonchain/skillsmith locally with Supabase and Gemini API keys.
Prompt 2
Explain how the Discover, Activate, and Forge stages work in this agent.
Prompt 3
Walk me through what happens when I ask a question none of the seeded skills cover.
Prompt 4
Explain what the three official Mantle skills in this project each do.

Frequently asked questions

What is skillsmith?

A research agent for the Mantle blockchain that answers questions with existing skills and creates new reusable skills on the fly when none fit.

What language is skillsmith written in?

Mainly TypeScript. The stack also includes Next.js, TypeScript, Tailwind CSS.

What license does skillsmith use?

No license information is provided in the README.

How hard is skillsmith to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is skillsmith for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.