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.

Project links

Data verified by PyPI on Aug 18, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.27.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for pace from gravatar.com pace

Credits

Author: pace

GitHub Statistics

Data verified by PyPI on Aug 18, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.14

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

3tears_agent_skills-0.26.1.tar.gz (84.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

3tears_agent_skills-0.26.1-py3-none-any.whl (50.3 kB view details)

Uploaded Python 3

File details

Details for the file 3tears_agent_skills-0.26.1.tar.gz.

File metadata

  • Download URL: 3tears_agent_skills-0.26.1.tar.gz
  • Upload date:
  • Size: 84.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for 3tears_agent_skills-0.26.1.tar.gz
Algorithm Hash digest
SHA256 e737d1fc30b2a40a0aa8ec703d26d75854f7f5d15d716b636eac44f07a7905a4
MD5 21c73846e224c9528908cf6fc0bd90a3
BLAKE2b-256 8021a9d2897d22f6db4d7edb98d234c2746fde49af70e35e564eda8b4d5bee65

See more details on using hashes here.

Provenance

The following attestation bundles were made for 3tears_agent_skills-0.26.1.tar.gz:

Publisher: release.yml on pacepace/3tears

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file 3tears_agent_skills-0.26.1-py3-none-any.whl.

File metadata

File hashes

Hashes for 3tears_agent_skills-0.26.1-py3-none-any.whl
Algorithm Hash digest
SHA256 bb4a97fc558a8351031bb37336aaebb33588e858f84a1f9a134a9b3c5d48d2a0
MD5 32698dadcb38b1a27f9224422e5e3c9b
BLAKE2b-256 4a655b37e32384917f6c0bd3af42be752c4d96772431f98ec81e8ebc7d79509e

See more details on using hashes here.

Provenance

The following attestation bundles were made for 3tears_agent_skills-0.26.1-py3-none-any.whl:

Publisher: release.yml on pacepace/3tears

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.27.0

2 files

This release

0.26.1 This release

2 files

0.26.0

2 files

0.25.0

2 files

0.24.7

2 files

0.24.6

2 files

0.24.5

2 files

0.24.4

2 files

0.24.3

2 files

0.24.2

2 files

0.24.1

2 files

0.24.0

2 files

0.23.11

2 files

0.23.10

2 files

0.23.9

2 files

0.23.8

2 files

0.23.7

2 files

0.23.6

2 files

0.23.5

2 files

0.23.3

2 files

0.23.2

2 files

0.23.1

2 files

0.23.0

2 files

0.22.5

2 files

0.22.4

2 files

0.22.3

2 files

0.22.2

2 files

0.22.1

2 files

0.22.0

2 files

0.21.0

2 files

0.20.0

2 files

0.19.4

2 files

0.19.3

2 files

0.19.2

2 files

0.19.1

2 files

0.19.0

2 files

0.18.0

2 files

0.17.9

2 files

0.17.8

2 files

0.17.7

2 files

0.17.6

2 files

0.17.5

2 files

0.17.4

2 files

0.17.3

2 files

0.17.2

2 files

0.17.1

2 files

0.17.0

2 files

0.16.1

2 files

0.16.0

2 files

0.15.0

2 files

0.14.1

2 files

0.14.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page