Use Skills
Discover, acquire, verify, and download Skill packages from Finch.
A Finch Skill is a versioned file or folder package. Read its content mode before you try to download it:
- Public — anyone can download the package without signing in.
- Protected — you must acquire the Skill and prove wallet ownership before Finch releases the package.
Price and protection are independent. A protected Skill can be free but still require acquisition.
1. Find a Skill
Open the Skill Market. Use keyword search, category, access, price, recent/price sorting, and grid/list view to narrow the catalog.
The combined Explore page also shows categories, trending Skills, recent items, and market highlights.
2. Review the detail page
Check the following before downloading or acquiring:
- name, summary, and full description;
- current version and release notes;
- chain and Skill identity;
- license;
- public or protected content mode;
- price, supply, and usage limit;
- creator, current owner, beneficiary, and royalty information when published;
- supported Agent clients;
- usage steps and example input/output;
- prerequisites and known limitations;
- file fingerprints and verification details;
- related Skills, references, and reviews when available.
Skill detail pages can expose five tabs: Information, Instruction, Benchmark, Showcase, and Review. A Publisher may use structured content or a static HTML presentation for the first four content tabs.
3. Download a public Skill
Public packages do not require a holding or wallet proof.
- Open the exact Skill detail page.
- Verify the chain, version, and package fingerprint.
- Select Download.
- Save to a new location instead of overwriting a trusted local copy.
- Review the package and its instructions before running or installing anything.
Treat downloaded code, prompts, scripts, and instructions as untrusted until you inspect them.
4. Acquire a protected Skill
- Sign in to the intended Finch Personal Account.
- Connect the wallet that should own the holding.
- Review the exact chain, version, price, supply, content mode, and package hash.
- Prepare the purchase.
- Review the wallet transaction, including asset, amount, recipient, and gas.
- Sign once and wait for confirmation.
- Confirm the Skill appears in Dashboard → Library.
- Request delivery and download the exact acquired version.
For Agent-client and CLI flows, Finch returns an authoritative purchase and delivery plan. Pass it to the official CLI unchanged. The CLI verifies the immutable package hash before writing the downloaded file.
Do not retry a purchase merely because the browser or client timed out. Check the existing operation and use the returned recovery path.
5. Use a downloaded Skill
A Skill package can contain code, documentation, prompts, workflows, or other capability files. The token or holding proves delivery rights; it does not prove that the package is safe or suitable for your environment.
Before use:
- inspect the files and instructions;
- confirm the license permits your use;
- identify network, file-system, account, or credential access;
- run untrusted code in an appropriately isolated environment;
- keep secrets out of prompts, logs, and package files;
- verify expected outputs on a safe test case.
6. Handle updates and versions
A Publisher can release a new version. A holding does not automatically mean that every newer version is compatible or included.
When Finch offers conversion:
- Inspect the old and new
(chainId, skillId, version)identities. - Read the new release notes and package hash.
- Prepare the conversion with the intended Account and wallet.
- Sign the exact returned action once.
- Verify old and new balances.
- Download the selected version explicitly.
7. Get support
Use the Publisher's documented support contact or the Skill's review area. Include public identifiers such as chain, Skill ID, version, and a sanitized transaction or operation reference. Never send a private key, seed phrase, content key, protected package, or bearer token.