3tears-agent-skills

Procedural memory for 3tears-based agents. Stores per-agent / per-user labeled markdown procedures (body) and tool-surface modifications (tool_additions, tool_restrictions) plus a prompt_mode enum controlling how the body interacts with the consumer's base system prompt.

This package provides the schema + Collection layer:

agent_skills -- one row per skill (partition column agent_id).
agent_skill_invocations -- one row per skill load with synchronous outcome tracking populated by the consumer's post-LLM hook (partition column agent_id; composite FK CASCADE on parent skill).
Two BaseEntity subclasses (AgentSkillEntity, AgentSkillInvocationEntity).
Two BaseCollection subclasses exposing the public skill-registry API.
A trigger-maintained search_vector (FTS for skill_list query-filter ranking; NOT auto-load).

Agent tools and the per-turn composition renderer do not live here.

Migration registration

from threetears.agent.skills import register as register_skills
from threetears.core.data.migrations import MigrationRunner

runner = MigrationRunner()
register_skills(runner)

Migrations are agent-scoped and depend on conversations (the invocation rows carry conversation_id -- ordering on apply, not an FK constraint).

`SkillRegistryClient` Protocol -- why this package takes no ACL / tools deps

agent-memory (a sibling package) takes direct dependencies on 3tears-agent-acl and 3tears-agent-tools because its memory tools need first-class ACL evaluator + tool-registry types in their public surface. agent-skills deliberately diverges. The tool factories take a thin SkillRegistryClient Protocol (three async methods, acl_permits / list_skill_eligible_tools / get_tool_introspect, plus a ConversationIdResolver / ActiveSkillProbe / ActiveSkillSetter callable triple wired by the consumer) instead of importing the ACL evaluator or the tool registry types directly.

The trade-off: callers must implement a small adapter (~10 lines over their existing NamespaceCollection + ACL cache + in-process tool registry), but agent-skills ships with zero hard deps beyond core and langchain-core. The consumer wires this; tests mock it. The ACL-via-evaluator approach targets the composition renderer, not the tools surface.

Future sibling packages should follow whichever pattern their public surface demands -- direct deps when types are part of the contract, Protocol when the contract is method-shaped and the deps are incidental.

Release files for 3tears-agent-skills 0.40.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for 3tears-agent-skills 0.40.0
File	Size	Uploaded
3tears_agent_skills-0.40.0.tar.gz	84.4 kB	Sep 13, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for 3tears-agent-skills 0.40.0
File	Interpreter	ABI	Platform	Reset
3tears_agent_skills-0.40.0-py3-none-any.whl 50.0 kB Sep 13, 2026	Python 3	none	any	Details

Total release size: 134.4 kB

Release files / 3tears_agent_skills-0.40.0.tar.gz

Download URL	3tears_agent_skills-0.40.0.tar.gz
Size	84.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`1e82d3bd42602f2148f2af05c00f14aa999619f4e3c5d33513cafa1fce0ed0e2`
BLAKE2b-256 checksum How to use checksums	`081cc270ac00c0d381be10ae3c33e04fb35c403e441dc36726bb000c0629f6bb`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pacepace/3tears
Publishing commit: github.com/pacepace/3tears/tree/3b9d6b01a8c33536d38e402f6b65c940b9e0c3fc

Workflow

Publishing configuration: github.com/pacepace/3tears/blob/3b9d6b01a8c33536d38e402f6b65c940b9e0c3fc/.github/workflows/release.yml
Publishing logs: github.com/pacepace/3tears/actions/runs/34773244737/attempts/2

Artifact

Subject: 3tears_agent_skills-0.40.0.tar.gz
SHA-256 checksum: 1e82d3bd42602f2148f2af05c00f14aa999619f4e3c5d33513cafa1fce0ed0e2 Verifying attestations

Release files / 3tears_agent_skills-0.40.0-py3-none-any.whl

Download URL	3tears_agent_skills-0.40.0-py3-none-any.whl
Size	50.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7346ff67a1d15062414f9019073d003eee5ab57c60c939c9755e6414609f1a31`
BLAKE2b-256 checksum How to use checksums	`1da9ad685167e2e1e04a5095b22c6322c691f3f80dbb0b83a83ef4d3ae412a14`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pacepace/3tears
Publishing commit: github.com/pacepace/3tears/tree/3b9d6b01a8c33536d38e402f6b65c940b9e0c3fc

Workflow

Publishing configuration: github.com/pacepace/3tears/blob/3b9d6b01a8c33536d38e402f6b65c940b9e0c3fc/.github/workflows/release.yml
Publishing logs: github.com/pacepace/3tears/actions/runs/34773244737/attempts/2

Artifact

Subject: 3tears_agent_skills-0.40.0-py3-none-any.whl
SHA-256 checksum: 7346ff67a1d15062414f9019073d003eee5ab57c60c939c9755e6414609f1a31 Verifying attestations