jk-sdk-setup
Installation
SKILL.md
Jinkō SDK Setup
Use this skill for SDK setup and credential checks only. Keep the user focused on proving that Python can authenticate against Jinkō and read one project item list before moving to model, vpop, protocol, output-set, or trial workflows.
Workflow
- Confirm the user has Python 3.10+.
- Install the SDK and dotenv support when needed:
pip install jinko python-dotenv. - Ask the user to create an API key using
https://doc.jinko.ai/docs/api/if they do not already have one. - Ask the user to set
JINKO_API_KEYandJINKO_PROJECT_IDin their shell or local.envfile. - Point them to
assets/.env.exampleas the safe template. Do not ask them to paste secrets into chat. - Run or adapt
scripts/check_jinko_connection.pyto fail fast on configuration, authentication, authorization, or project-read-access issues. - If the check passes, report that the Jinkō connection is OK.
- When the user wants to browse the project after setup, recommend
client.search(...)as the default read-only exploration call before moving to a workflow-specific skill.
Required Configuration
JINKO_API_KEY: API key created in the Jinkō web interface.JINKO_PROJECT_ID: project identifier used by the SDK forX-jinko-project-id.