{"_id":"@carlosgtrz/tpsreader-agent-skill","_rev":"5-ff83049dff1989bbd6b68eb5d4d7235e","name":"@carlosgtrz/tpsreader-agent-skill","dist-tags":{"latest":"1.0.4"},"versions":{"1.0.0":{"name":"@carlosgtrz/tpsreader-agent-skill","version":"1.0.0","keywords":["pi-package","agent-skill","clarion","topspeed","tps","database","read-only"],"author":{"name":"CarlosGtrz"},"license":"Apache-2.0","_id":"@carlosgtrz/tpsreader-agent-skill@1.0.0","maintainers":[{"name":"carlosgtrz","email":"carlosg@sca.com.mx"}],"homepage":"https://github.com/CarlosGtrz/TpsReader#agent-skill","bugs":{"url":"https://github.com/CarlosGtrz/TpsReader/issues"},"pi":{"skills":["./skills"]},"dist":{"shasum":"00acaaea9cd92a3e5390c6327cfdeb1a2ca2b516","tarball":"https://registry.npmjs.org/@carlosgtrz/tpsreader-agent-skill/-/tpsreader-agent-skill-1.0.0.tgz","fileCount":8,"integrity":"sha512-uR9rV2G4E9O+RxX3n7F+VT/f63RD8cXzeMbFr1RmIanjH2hWda9ottNQJfEYTepTtmIlDECcIJzXOSH9CioeSA==","signatures":[{"sig":"MEUCIByVUZiQV8rVXpnzA6qoKTokinFcVDT6ykOK5noGrPC/AiEAhqe9uNXUYxcsi3t4TWpc+UIfc2jzZB+rHa+VlxTs84A=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27164},"_from":"file:L:/ai/tpsparser-csharp/artifacts/skill-v1.0.0-release-bcfe900e35bc4ce6811b9c470fca9aea/dist/carlosgtrz-tpsreader-agent-skill-1.0.0.tgz","_npmUser":{"name":"carlosgtrz","email":"carlosg@sca.com.mx"},"_resolved":"L:\\ai\\tpsparser-csharp\\artifacts\\skill-v1.0.0-release-bcfe900e35bc4ce6811b9c470fca9aea\\dist\\carlosgtrz-tpsreader-agent-skill-1.0.0.tgz","_integrity":"sha512-uR9rV2G4E9O+RxX3n7F+VT/f63RD8cXzeMbFr1RmIanjH2hWda9ottNQJfEYTepTtmIlDECcIJzXOSH9CioeSA==","repository":{"url":"git+https://github.com/CarlosGtrz/TpsReader.git","type":"git","directory":"plugins/tpsreader"},"_npmVersion":"11.11.0","description":"Multi-agent skill for safely reading Clarion TopSpeed TPS files with TpsReader.","directories":{},"_nodeVersion":"22.21.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/tpsreader-agent-skill_1.0.0_1784831029795_0.30450230834863246","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@carlosgtrz/tpsreader-agent-skill","version":"1.0.1","keywords":["pi-package","agent-skill","clarion","topspeed","tps","database","read-only"],"author":{"name":"CarlosGtrz"},"license":"Apache-2.0","_id":"@carlosgtrz/tpsreader-agent-skill@1.0.1","maintainers":[{"name":"carlosgtrz","email":"carlosg@sca.com.mx"}],"homepage":"https://github.com/CarlosGtrz/TpsReader#agent-skill","bugs":{"url":"https://github.com/CarlosGtrz/TpsReader/issues"},"pi":{"skills":["./skills"]},"dist":{"shasum":"d366d8dbe559076bd5f2fba7f40cda15d487b3b6","tarball":"https://registry.npmjs.org/@carlosgtrz/tpsreader-agent-skill/-/tpsreader-agent-skill-1.0.1.tgz","fileCount":8,"integrity":"sha512-LfbymQvgaPbZ19y+DMra8QYFpq55d+8N7y8R3wd7JFXaap/lYz6SHnClzV9a0TGKHuMfv8MxSdasmCe2UYeeRA==","signatures":[{"sig":"MEYCIQCaBahT+rrquR3iKFvtMMXiPf22xH8bcXT1bLZl5XQrpQIhAIVP69LyhOtYrwiTGX5GU688mpLJHuKlU6g8XFd4MuFE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28942},"_from":"file:L:/ai/tpsparser-csharp/artifacts/skill-v1.0.1-release-e8adf0c/dist/carlosgtrz-tpsreader-agent-skill-1.0.1.tgz","_npmUser":{"name":"carlosgtrz","email":"carlosg@sca.com.mx"},"_resolved":"L:\\ai\\tpsparser-csharp\\artifacts\\skill-v1.0.1-release-e8adf0c\\dist\\carlosgtrz-tpsreader-agent-skill-1.0.1.tgz","_integrity":"sha512-LfbymQvgaPbZ19y+DMra8QYFpq55d+8N7y8R3wd7JFXaap/lYz6SHnClzV9a0TGKHuMfv8MxSdasmCe2UYeeRA==","repository":{"url":"git+https://github.com/CarlosGtrz/TpsReader.git","type":"git","directory":"plugins/tpsreader"},"_npmVersion":"11.11.0","description":"Multi-agent skill for safely reading Clarion TopSpeed TPS files with TpsReader.","directories":{},"_nodeVersion":"22.21.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/tpsreader-agent-skill_1.0.1_1784907469040_0.3041601575812731","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@carlosgtrz/tpsreader-agent-skill","version":"1.0.2","keywords":["pi-package","agent-skill","clarion","topspeed","tps","database","read-only"],"author":{"name":"CarlosGtrz"},"license":"Apache-2.0","_id":"@carlosgtrz/tpsreader-agent-skill@1.0.2","maintainers":[{"name":"carlosgtrz","email":"carlosg@sca.com.mx"}],"homepage":"https://github.com/CarlosGtrz/TpsReader#agent-skill","bugs":{"url":"https://github.com/CarlosGtrz/TpsReader/issues"},"pi":{"skills":["./skills"]},"dist":{"shasum":"2e8104195a23dbdcf0d5716a21ca35208c622883","tarball":"https://registry.npmjs.org/@carlosgtrz/tpsreader-agent-skill/-/tpsreader-agent-skill-1.0.2.tgz","fileCount":8,"integrity":"sha512-qohNQAUHzUkcBDrzYKqaxdA7SL4+Es0IRTwvLERV518MZ8vcbhJmliBBf+y3Gg0t1li2HQGC9Of1qUly3xt0GA==","signatures":[{"sig":"MEUCIBEt4XMxDTRR6shfebpvnXadMhIaUxvBeSDHerhrZUu8AiEApvyddS7+eR2KwBWfLtbDk0hdkMcejii5CoL5WMROl7M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28942},"_from":"file:L:/ai/tpsparser-csharp/artifacts/skill-v1.0.2-release/dist/carlosgtrz-tpsreader-agent-skill-1.0.2.tgz","_npmUser":{"name":"carlosgtrz","email":"carlosg@sca.com.mx"},"_resolved":"L:\\ai\\tpsparser-csharp\\artifacts\\skill-v1.0.2-release\\dist\\carlosgtrz-tpsreader-agent-skill-1.0.2.tgz","_integrity":"sha512-qohNQAUHzUkcBDrzYKqaxdA7SL4+Es0IRTwvLERV518MZ8vcbhJmliBBf+y3Gg0t1li2HQGC9Of1qUly3xt0GA==","repository":{"url":"git+https://github.com/CarlosGtrz/TpsReader.git","type":"git","directory":"plugins/tpsreader"},"_npmVersion":"11.11.0","description":"Multi-agent skill for safely reading Clarion TopSpeed TPS files with TpsReader.","directories":{},"_nodeVersion":"22.21.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/tpsreader-agent-skill_1.0.2_1785109638582_0.45063444236802197","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@carlosgtrz/tpsreader-agent-skill","version":"1.0.3","keywords":["pi-package","agent-skill","clarion","topspeed","tps","database","read-only"],"author":{"name":"CarlosGtrz"},"license":"Apache-2.0","_id":"@carlosgtrz/tpsreader-agent-skill@1.0.3","maintainers":[{"name":"carlosgtrz","email":"carlosg@sca.com.mx"}],"homepage":"https://github.com/CarlosGtrz/TpsReader#agent-skill","bugs":{"url":"https://github.com/CarlosGtrz/TpsReader/issues"},"pi":{"skills":["./skills"]},"dist":{"shasum":"865476506eb1a4ee77ee03cc92b2b75d36e293d6","tarball":"https://registry.npmjs.org/@carlosgtrz/tpsreader-agent-skill/-/tpsreader-agent-skill-1.0.3.tgz","fileCount":8,"integrity":"sha512-RXi2kvFL/7riYii+i1K1L2uqgV2fD+nd7iBiWx6CXfHs9nh34C+sHJL4H0tR2GZmw0Z7yaDTOat/Sghf3cIRVA==","signatures":[{"sig":"MEYCIQCjo63TeekfXXyouXAFzBcZ554d4i0yr8YLfE8HIsN3ZwIhAMkKEzG/pY0G31Re1NqBzrldBzH//vaDqMNYJDRi7Faa","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28942},"_from":"file:L:/ai/tpsparser-csharp/artifacts/skill-v1.0.3-release-6441e49/dist/carlosgtrz-tpsreader-agent-skill-1.0.3.tgz","_npmUser":{"name":"carlosgtrz","email":"carlosg@sca.com.mx"},"_resolved":"L:\\ai\\tpsparser-csharp\\artifacts\\skill-v1.0.3-release-6441e49\\dist\\carlosgtrz-tpsreader-agent-skill-1.0.3.tgz","_integrity":"sha512-RXi2kvFL/7riYii+i1K1L2uqgV2fD+nd7iBiWx6CXfHs9nh34C+sHJL4H0tR2GZmw0Z7yaDTOat/Sghf3cIRVA==","repository":{"url":"git+https://github.com/CarlosGtrz/TpsReader.git","type":"git","directory":"plugins/tpsreader"},"_npmVersion":"11.11.0","description":"Multi-agent skill for safely reading Clarion TopSpeed TPS files with TpsReader.","directories":{},"_nodeVersion":"22.21.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/tpsreader-agent-skill_1.0.3_1786734124348_0.5168646687569753","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@carlosgtrz/tpsreader-agent-skill","version":"1.0.4","description":"Multi-agent skill for safely reading Clarion TopSpeed TPS files with TpsReader.","license":"Apache-2.0","author":{"name":"CarlosGtrz"},"homepage":"https://github.com/CarlosGtrz/TpsReader#agent-skill","repository":{"type":"git","url":"git+https://github.com/CarlosGtrz/TpsReader.git","directory":"plugins/tpsreader"},"bugs":{"url":"https://github.com/CarlosGtrz/TpsReader/issues"},"keywords":["pi-package","agent-skill","clarion","topspeed","tps","database","read-only"],"publishConfig":{"access":"public"},"pi":{"skills":["./skills"]},"_id":"@carlosgtrz/tpsreader-agent-skill@1.0.4","_integrity":"sha512-Ttw0sC9+KCmPQpMGNPVZPu1aipDIidkxF4eMVCfKerVesaCutqaIbGgG1wHAOWt4u4OCkABe6vCABPvbdk2ohw==","_resolved":"L:\\ai\\tpsparser-csharp\\artifacts\\skill-v1.0.4-release-prep\\dist\\carlosgtrz-tpsreader-agent-skill-1.0.4.tgz","_from":"file:L:/ai/tpsparser-csharp/artifacts/skill-v1.0.4-release-prep/dist/carlosgtrz-tpsreader-agent-skill-1.0.4.tgz","_nodeVersion":"22.21.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-Ttw0sC9+KCmPQpMGNPVZPu1aipDIidkxF4eMVCfKerVesaCutqaIbGgG1wHAOWt4u4OCkABe6vCABPvbdk2ohw==","shasum":"6be908cc617a0e38a703eb05c63dfef1aeeac5ba","tarball":"https://registry.npmjs.org/@carlosgtrz/tpsreader-agent-skill/-/tpsreader-agent-skill-1.0.4.tgz","fileCount":8,"unpackedSize":28942,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBWkoV+9RGPbXohszgY1NX3BtK4IHvvlaOHdQBBLUBImAiEAzu9ul/v2AUA3j6PO+BxAaXdof2YsXuB92Gfo9C4Ouhc="}]},"_npmUser":{"name":"carlosgtrz","email":"carlosg@sca.com.mx"},"directories":{},"maintainers":[{"name":"carlosgtrz","email":"carlosg@sca.com.mx"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/tpsreader-agent-skill_1.0.4_1787440547232_0.4988720767478443"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-23T18:23:49.681Z","modified":"2026-08-22T23:15:47.546Z","1.0.0":"2026-07-23T18:23:49.982Z","1.0.1":"2026-07-24T15:37:49.193Z","1.0.2":"2026-07-26T23:47:18.797Z","1.0.3":"2026-08-14T19:02:04.490Z","1.0.4":"2026-08-22T23:15:47.388Z"},"bugs":{"url":"https://github.com/CarlosGtrz/TpsReader/issues"},"author":{"name":"CarlosGtrz"},"license":"Apache-2.0","homepage":"https://github.com/CarlosGtrz/TpsReader#agent-skill","keywords":["pi-package","agent-skill","clarion","topspeed","tps","database","read-only"],"repository":{"type":"git","url":"git+https://github.com/CarlosGtrz/TpsReader.git","directory":"plugins/tpsreader"},"description":"Multi-agent skill for safely reading Clarion TopSpeed TPS files with TpsReader.","maintainers":[{"name":"carlosgtrz","email":"carlosg@sca.com.mx"}],"readme":"# TpsReader Agent Skill\n\nUse the `read-tps-files` Agent Skill to inspect schemas, run bounded read-only queries, and explicitly export Clarion TopSpeed (`.TPS`) files with the [TpsReader CLI](https://github.com/CarlosGtrz/TpsReader).\n\nThe same skill is packaged for Codex, Claude Code, and Pi. Source TPS files are always treated as immutable.\n\n## Prerequisites\n\nThe skill first uses a compatible global `tps` command. Install the .NET tool with:\n\n```text\ndotnet tool install --global TpsReader.Tool\n```\n\nWhen .NET 8 or later is unavailable, the skill can offer an explicit, user-approved download of a verified native executable from an official TpsReader GitHub release. It never installs or updates tools automatically.\n\n## Install\n\n### Codex\n\n```text\ncodex plugin marketplace add CarlosGtrz/TpsReader --sparse .agents/plugins --sparse plugins\ncodex plugin add tpsreader@tpsreader\n```\n\nInvoke the skill as `$read-tps-files`.\n\n### Claude Code\n\n```text\nclaude plugin marketplace add CarlosGtrz/TpsReader --sparse .claude-plugin plugins\nclaude plugin install tpsreader@tpsreader\n```\n\nInvoke the skill as `/tpsreader:read-tps-files`.\n\n### Pi\n\n```text\npi install npm:@carlosgtrz/tpsreader-agent-skill@1.0.4\n```\n\nInvoke the skill as `/skill:read-tps-files`, or let Pi select it from the task.\n\n## Examples\n\n```text\nUse read-tps-files to show the schema of C:\\data\\CUSTOMER.TPS.\n```\n\n```text\nQuery customer number and company from CUSTOMER.TPS, limited to 20 rows.\n```\n\n```text\nExport the CUSTOMER table from CUSTOMER.TPS to C:\\exports.\n```\n\nThe skill discovers schema before reading rows, uses explicit limits, keeps owner keys out of command arguments, and requests confirmation before potentially overwriting export files.\n\nThe skill requires TpsReader CLI 0.4.1 or later. It verifies `tps --version`\nand command compatibility before use. Missing or incompatible tools are never\ninstalled or updated without confirmation.\n\n## Supported platforms\n\nThe .NET global tool works wherever a compatible .NET runtime is available. Verified native fallback downloads are limited to:\n\n- Windows x64 (`win-x64`)\n- glibc Linux x64 (`linux-x64`)\n- Apple silicon macOS (`osx-arm64`)\n\nOther platforms require the .NET global tool.\n\n## Versioning\n\nThis Agent Skill uses independent semantic versions. A skill release does not change the TpsReader library or CLI version, and native executables remain separate TpsReader release assets rather than npm package contents.\n\n## Permissions and network access\n\n- TPS source files are read-only and are never moved, deleted, replaced, or overwritten.\n- Exports occur only after an explicit request and may create CSV and BLOB files in the chosen destination.\n- Owner values are read only through a user-provided environment variable.\n- GitHub network access occurs only when resolving a native fallback or when the user explicitly requests an update.\n- Native downloads require confirmation and are verified by asset size, SHA-256, archive structure, executable hash, and CLI capabilities before use.\n- Native executables are stored in a per-user TpsReader cache, never in the plugin installation.\n- TPS contents and parser output are treated as untrusted data, not instructions.\n\n## Update and remove\n\nCodex:\n\n```text\ncodex plugin marketplace upgrade tpsreader\ncodex plugin remove tpsreader@tpsreader\ncodex plugin add tpsreader@tpsreader\n```\n\n```text\ncodex plugin remove tpsreader@tpsreader\ncodex plugin marketplace remove tpsreader\n```\n\nClaude Code:\n\n```text\nclaude plugin update tpsreader@tpsreader\n```\n\n```text\nclaude plugin uninstall tpsreader@tpsreader\nclaude plugin marketplace remove tpsreader\n```\n\nPi:\n\n```text\npi update npm:@carlosgtrz/tpsreader-agent-skill\n```\n\n```text\npi remove npm:@carlosgtrz/tpsreader-agent-skill\n```\n\nRemoving the package does not remove a separately installed .NET global tool or a user-approved native cache entry.\n\n## License\n\nApache-2.0. See [LICENSE](LICENSE).\n","readmeFilename":"README.md"}