Fintel DataFinance Skill
A three-file guide to security lookup, short data, reported ownership, insiders, prices and account resources through Fintel. It distinguishes data reads from write endpoints and documents warnings and entitlement errors. Current history defaults differ from the captured guide, and local credential setup or MCP registration can modify files. Preserve observation dates and dataset meanings; no credentials, installation or authenticated market responses were tested.
- Assessment score
- 87/100
- Snapshot risk
- Medium
- Audit conclusion
- Needs review
How the assessment score works
Pineify weights evidence recorded from the captured files: Skill structure 15%, Instruction clarity 20%, Dependency transparency 20%, Permission transparency 20%, Safety guardrails 15%, Finance task fit 10%. Each signal receives full credit for Yes, one-quarter credit for unknown, and none for No.
The score is not an output accuracy test or user rating. Read the findings and financial assumptions even when the score is high. Risk labels summarize recorded permissions and findings; they do not measure investment risk or certify that installation is safe.
Discovery
What this Skill helps an agent do.
Use the tasks and topics below to judge whether the captured workflow fits your question. Read its findings, dependencies and data requirements before relying on an output.
Domains and assets
Topics
Trust
Evidence from the captured directory.
This content snapshot assessment does not certify the repository, current files, or installation environment. "Not verified" means the captured files did not support a Yes or No conclusion.
License
GitHub reports the repository license as MIT License.
Review state
- Automated review
- Automated review
- Install tested
- No
- Human reviewed
- Not verified
Snapshot
- Files reviewed
- 3
- Captured
- 2026-07-29 07:31 UTC
- Snapshot ID
- fsh-fintel-data-2026-07-29-001
Permissions
FilesystemRead
YesThe skill reads .env files from the current directory and git repo root to resolve the API key.
FilesystemWrite
YesThe data workflow requests read operations, but optional claude mcp add persists client configuration and the README also describes adding a key to a local .env file.
NetworkAccess
YesThe skill uses curl to call the Fintel REST API and optionally registers an MCP server.
ShellExecution
YesThe skill instructs the agent to use curl for API requests and shell scripts for API key resolution.
CodeExecution
YesThe skill pipes API responses through python3 -m json.tool for formatting.
ExternalCredentials
YesThe skill requires a FINTEL_API_KEY for all API calls, resolved from env var or .env files.
Dependencies
curl
Available in shell
Shell tool for HTTP requests to the Fintel REST API.
python3
Python 3 for JSON formatting
Optional, used for formatting JSON output.
Fintel API
FINTEL_API_KEY and account entitlement required
External API providing institutional market intelligence including short interest, borrow rates, 13F ownership, and insider transactions.
Data sources named by the Skill
Fintel REST API / optional MCP
Provides short interest, borrow rates, short volume, FTD, 13F institutional ownership, insider transactions, analyst estimates, EOD prices, and more.
Snapshot assessment
87/100
Pineify Finance Skill snapshot assessment, version 1.0.0. Generated 2026-10-20 00:00 UTC.
Medium risk · Needs review
Skill structure
100/100Instruction clarity
100/100Dependency transparency
65/100Permission transparency
75/100Safety guardrails
100/100Finance task fit
85/100Audit findings
Medium
Captured history defaults are stale
The current OpenAPI documents short-interest as latest by default with bounded history via limit; short-volume and fails-to-deliver also document a default limit of 1. A trailing-year label does not mean one default request returns a full year. The current leaderboard contract describes dated rows and unavailable-service errors, not a universal beta-equals-stub rule. Verify each response and entitlement; this audit made no authenticated data requests.
Medium
Short activity and reported ownership have different meanings
Daily short-sale volume is trading activity, not outstanding short interest. 13F-derived holdings describe reported periods rather than live ownership; preserve report and filing dates. Borrow availability and fees are provider observations, not a calibrated squeeze probability. Keep transaction codes and source filings when distinguishing purchases, sales and option exercises.
Medium
Dependency manifest is absent from the snapshot
No requirements.txt or equivalent manifest is included in the captured directory.
Medium
Fintel API access and dataset entitlement are required
API-key access is metered and account-aware. Short-interest access must be enabled for the account; current pricing and entitlement should be checked with Fintel.
Medium
Data reads and local setup have separate effects
REST read examples and MCP read tools do not place trades. Optional MCP registration modifies local configuration and includes an API key in the command; review secret storage before configuring a client. Public capabilities do not prove that a particular account has access. The captured platform restriction is not evidence that every current hosted agent lacks connectivity.
Low
Reads .env files for API key resolution
The fallback reads local .env files and extracts the matching FINTEL_API_KEY line. It is a narrow text parser, not a full dotenv parser; quoted paths, comments and nonstandard Git layouts require review. Do not display the extracted key or paste it into reports.
Sources and relations
Context around this Skill.
Repository
himself65/finance-skills
topic
Short interest & borrow
topic
Institutional ownership
topic
Insider transactions
agent
Claude Code
collection
Data providers
guide
Reviewing finance skills before install
Registry
Read this record as data.
The public record includes the page-safe snapshot, evidence, assessment, taxonomy, and relations. Internal revision fields stay outside the public projection.
- Record ID
- github:himself65/finance-skills:plugins/data-providers/skills/fintel-data
- Snapshot ID
- fsh-fintel-data-2026-07-29-001