diff --git a/CHANGELOG.md b/CHANGELOG.md
index a35155c..26d754a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - Add `SpecPredicate` and `tag_maybe` to the public interface (#49)
 
+### Fixed
+- Predicates decorated by `pred_to_validator` will now properly be converted into
+  validator specs (#54)
+
 ## [v0.2.4] - 2019-12-19
 ### Added
 - Add `s.blankable` Spec for specifying optional string values (#45)
diff --git a/README.md b/README.md
index 7ee2125..d59c11a 100644
--- a/README.md
+++ b/README.md
@@ -112,6 +112,44 @@ spec.is_valid("4716df50-0aa0-4b7d-98a4-1f2b2bcb1c6b")  # True
 spec.is_valid("b4e9735a-ee8c-11e9-8708-4c327592fea9")  # False
 ```
 
+### Validator Specs
+
+Simple predicates make fine specs, but are unable to provide more details to the caller
+about exactly why the input value failed to validate. Validator specs directly yield
+`ErrorDetails` objects which can indicate more precisely why the input data is failing
+to validate.
+
+```python
+def _is_positive_int(v: Any) -> Iterable[ErrorDetails]:
+    if not isinstance(v, int):
+        yield ErrorDetails(
+            message="Value must be an integer", pred=_is_positive_int, value=v
+        )
+    elif v < 1:
+        yield ErrorDetails(
+            message="Number must be greater than 0", pred=_is_positive_int, value=v
+        )
+
+spec = s(_is_positive_int)
+spec.is_valid(5)      # True
+spec.is_valid(0.5)    # False
+spec.validate_ex(-1)  # ValidationError(errors=[ErrorDetails(message="Number must be greater than 0", ...)])
+```
+
+Simple predicates can be converted into validator functions using the builtin
+`pred_to_validator` decorator:
+
+```python
+@pred_to_validator("Number must be greater than 0")
+def _is_positive_num(v: Union[int, float]) -> bool:
+    return v > 0
+
+spec = s(_is_positive_num)
+spec.is_valid(5)      # True
+spec.is_valid(0.5)    # True
+spec.validate_ex(-1)  # ValidationError(errors=[ErrorDetails(message="Number must be greater than 0", ...)])
+```
+
 ### UUID Specs
 
 In the previous section, we used a simple predicate to check that a UUID was a certain
@@ -397,6 +435,24 @@ All Specs can be created with optional tags, specified as a string in the first
 positional argument of any spec creation function. Tags are useful for providing
 useful names for specs in debugging and validation messages.
 
+## Patterns
+
+### Factories
+
+Often when validating documents such as a CSV or a JSON blob, you'll find yourself
+writing a series of similar specs again and again. In situations like these, it is
+recommended to create a factory function for generating specs consistently. `dataspec`
+uses this pattern for many of the common spec types described above. This encourages
+reuse of commonly used specs and should help enforce consistency across your domain.
+
+### Reuse
+
+Specs are designed to be immutable, so they may be reused in many different contexts.
+Often, the only the that changes between uses is the tag or conformer. Specs provide a
+convenient API for generating copies of themselves (not modifying the original) which
+update only the relevant attribute. Additionally, Specs can be combined in many useful
+ways to avoid having to redefine common validations repeatedly.
+
 ## License
 
 MIT License
diff --git a/src/dataspec/base.py b/src/dataspec/base.py
index b46fedd..5c9915e 100644
--- a/src/dataspec/base.py
+++ b/src/dataspec/base.py
@@ -677,6 +677,7 @@ def pred_to_validator(
                     value=v,
                 )
 
+        validator.is_validator_fn = True  # type: ignore
         return validator
 
     return to_validator
@@ -731,7 +732,9 @@ def make_spec(  # pylint: disable=inconsistent-return-statements
             # Some builtins may not be inspectable
             sig = None
 
-        if sig is not None and sig.return_annotation is Iterator[ErrorDetails]:
+        if (
+            sig is not None and sig.return_annotation is Iterator[ErrorDetails]
+        ) or getattr(pred, "is_validator_fn", False):
             return ValidatorSpec(
                 tag or pred.__name__, cast(ValidatorFn, pred), conformer=conformer
             )

Predicates decorated by `pred_to_validator` are not properly converted into Validator Specs
```python
from dataspec import s, pred_to_validator

>>> @pred_to_validator("This value is invalid")
... def is_valid(v) -> bool:
...     return bool(v)
...
>>> spec = s(is_valid)
>>> spec
PredicateSpec(tag='is_valid', _pred=<function is_valid at 0x109a09b70>, _conformer=None)
```

This created workarounds requiring people to import `ValidatorSpec` from `dataspec.base`.
diff --git a/tests/test_api.py b/tests/test_api.py
index f80a7eb..b5c19a5 100644
--- a/tests/test_api.py
+++ b/tests/test_api.py
@@ -3,7 +3,7 @@ from typing import Iterator
 import pytest
 
 from dataspec import ErrorDetails, ValidationError, s
-from dataspec.base import PredicateSpec, ValidatorSpec
+from dataspec.base import PredicateSpec, ValidatorSpec, pred_to_validator
 
 
 class TestSpecConstructor:
@@ -34,6 +34,13 @@ class TestSpecConstructor:
 
         assert isinstance(s(is_valid), PredicateSpec)
 
+    def test_pred_to_validator(self):
+        @pred_to_validator("This value is invalid")
+        def is_valid(v) -> bool:
+            return bool(v)
+
+        assert isinstance(s(is_valid), ValidatorSpec)
+
     def test_no_signature_for_builtins(self):
         s.all(s.str(), str.istitle)
 

pip install -e .[dev]
parse_log_pytest
requirements.txt
3.7
requirements.txt requirements.dev.txt
pytest --no-header -rA --tb=line --color=no -p no:cacheprovider -W ignore::DeprecationWarning
attrs==24.2.0
black==23.3.0
bleach==6.0.0
cachetools==5.5.2
certifi @ file:///croot/certifi_1671487769961/work/certifi
cffi==1.15.1
chardet==5.2.0
charset-normalizer==3.4.1
click==8.1.8
colorama==0.4.6
cryptography==44.0.2
-e git+https://github.com/coverahealth/dataspec.git@cc1879448aac512d1da4003c427e12bd1a793f10#egg=dataspec
distlib==0.3.9
docutils==0.20.1
exceptiongroup==1.2.2
filelock==3.12.2
idna==3.10
importlib-metadata==6.7.0
importlib-resources==5.12.0
iniconfig==2.0.0
isort==5.11.5
jaraco.classes==3.2.3
jeepney==0.9.0
keyring==24.1.1
markdown-it-py==2.2.0
mdurl==0.1.2
more-itertools==9.1.0
mypy-extensions==1.0.0
packaging==24.0
pathspec==0.11.2
phonenumbers==9.0.2
pkginfo==1.10.0
platformdirs==4.0.0
pluggy==1.2.0
pycparser==2.21
Pygments==2.17.2
pyproject-api==1.5.3
pytest==7.4.4
python-dateutil==2.9.0.post0
readme-renderer==37.3
requests==2.31.0
requests-toolbelt==1.0.0
rfc3986==2.0.0
rich==13.8.1
SecretStorage==3.3.3
six==1.17.0
tomli==2.0.1
tox==4.8.0
twine==4.0.2
typed-ast==1.5.5
typing_extensions==4.7.1
urllib3==2.0.7
virtualenv==20.26.6
webencodings==0.5.1
zipp==3.15.0

name: dataspec
channels:
  - defaults
  - https://repo.anaconda.com/pkgs/main
  - https://repo.anaconda.com/pkgs/r
  - conda-forge
dependencies:
  - _libgcc_mutex=0.1=main
  - _openmp_mutex=5.1=1_gnu
  - ca-certificates=2025.2.25=h06a4308_0
  - certifi=2022.12.7=py37h06a4308_0
  - ld_impl_linux-64=2.40=h12ee557_0
  - libffi=3.4.4=h6a678d5_1
  - libgcc-ng=11.2.0=h1234567_1
  - libgomp=11.2.0=h1234567_1
  - libstdcxx-ng=11.2.0=h1234567_1
  - ncurses=6.4=h6a678d5_0
  - openssl=1.1.1w=h7f8727e_0
  - pip=22.3.1=py37h06a4308_0
  - python=3.7.16=h7a1cb2a_0
  - readline=8.2=h5eee18b_0
  - setuptools=65.6.3=py37h06a4308_0
  - sqlite=3.45.3=h5eee18b_0
  - tk=8.6.14=h39e8969_0
  - wheel=0.38.4=py37h06a4308_0
  - xz=5.6.4=h5eee18b_1
  - zlib=1.2.13=h5eee18b_1
  - pip:
      - attrs==24.2.0
      - black==23.3.0
      - bleach==6.0.0
      - cachetools==5.5.2
      - cffi==1.15.1
      - chardet==5.2.0
      - charset-normalizer==3.4.1
      - click==8.1.8
      - colorama==0.4.6
      - cryptography==44.0.2
      - dataspec==0.2.dev5
      - distlib==0.3.9
      - docutils==0.20.1
      - exceptiongroup==1.2.2
      - filelock==3.12.2
      - idna==3.10
      - importlib-metadata==6.7.0
      - importlib-resources==5.12.0
      - iniconfig==2.0.0
      - isort==5.11.5
      - jaraco-classes==3.2.3
      - jeepney==0.9.0
      - keyring==24.1.1
      - markdown-it-py==2.2.0
      - mdurl==0.1.2
      - more-itertools==9.1.0
      - mypy-extensions==1.0.0
      - packaging==24.0
      - pathspec==0.11.2
      - phonenumbers==9.0.2
      - pkginfo==1.10.0
      - platformdirs==4.0.0
      - pluggy==1.2.0
      - pycparser==2.21
      - pygments==2.17.2
      - pyproject-api==1.5.3
      - pytest==7.4.4
      - python-dateutil==2.9.0.post0
      - readme-renderer==37.3
      - requests==2.31.0
      - requests-toolbelt==1.0.0
      - rfc3986==2.0.0
      - rich==13.8.1
      - secretstorage==3.3.3
      - six==1.17.0
      - tomli==2.0.1
      - tox==4.8.0
      - twine==4.0.2
      - typed-ast==1.5.5
      - typing-extensions==4.7.1
      - urllib3==2.0.7
      - virtualenv==20.26.6
      - webencodings==0.5.1
      - zipp==3.15.0
prefix: /opt/conda/envs/dataspec

tests/test_api.py::TestSpecConstructor::test_pred_to_validator
tests/test_api.py::TestSpecConstructor::test_invalid_specs[None] tests/test_api.py::TestSpecConstructor::test_invalid_specs[5] tests/test_api.py::TestSpecConstructor::test_invalid_specs[3.14] tests/test_api.py::TestSpecConstructor::test_invalid_specs[8j] tests/test_api.py::TestSpecConstructor::test_spec_with_no_pred tests/test_api.py::TestSpecConstructor::test_validator_spec tests/test_api.py::TestSpecConstructor::test_predicate_spec tests/test_api.py::TestSpecConstructor::test_no_signature_for_builtins tests/test_api.py::TestFunctionSpecs::test_arg_specs tests/test_api.py::TestFunctionSpecs::test_kwarg_specs tests/test_api.py::TestFunctionSpecs::test_return_spec
src/dataspec/base.py README.md CHANGELOG.md
src/dataspec/base.py README.md CHANGELOG.md